app/local-environments.md +13 −10
1# Local environments1# Local environments
2 2
3Configure common actions and setup scripts for worktrees
4
5Local environments let you configure setup steps for worktrees as well as common actions for a project.3Local environments let you configure setup steps for worktrees as well as common actions for a project.
6 4
7You configure your local environments through the [Codex app settings](codex://settings) pane. You can check the generated file into your project's Git repository to share with others.5You configure your local environments through the [Codex app settings](codex://settings) pane. You can check the generated file into your project's Git repository to share with others.
27 25
28## Actions26## Actions
29 27
28<section class="feature-grid">
29
30<div>
30Use actions to define common tasks like starting your app's development server or running your test suite. These actions appear in the Codex app top bar for quick access. The actions will be run within the app's [integrated terminal](https://developers.openai.com/codex/app/features#integrated-terminal).31Use actions to define common tasks like starting your app's development server or running your test suite. These actions appear in the Codex app top bar for quick access. The actions will be run within the app's [integrated terminal](https://developers.openai.com/codex/app/features#integrated-terminal).
31 32
32Actions are helpful to keep you from typing common actions like triggering a build for your project or starting a development server. For one-off quick debugging you can use the integrated terminal directly.33Actions are helpful to keep you from typing common actions like triggering a build for your project or starting a development server. For one-off quick debugging you can use the integrated terminal directly.
33 34
3435 </div>
36
37<CodexScreenshot
38 alt="Project actions list shown in Codex app settings"
39 lightSrc="/images/codex/app/actions-light.webp"
40 darkSrc="/images/codex/app/actions-dark.webp"
41 maxHeight="400px"
42 class="mb-4 lg:mb-0"
43/>
35 44
3645 </section>
37 46
38For example, for a Node.js project you might create a "Run" action that contains the following script:47For example, for a Node.js project you might create a "Run" action that contains the following script:
39 48
44If the commands for your action are platform-specific, define platform-specific scripts for macOS, Windows, and Linux.53If the commands for your action are platform-specific, define platform-specific scripts for macOS, Windows, and Linux.
45 54
46To identify your actions, choose an icon associated with each action.55To identify your actions, choose an icon associated with each action.
47
48[Previous
49
50Worktrees](https://developers.openai.com/codex/app/worktrees)[Next
51
52Commands](https://developers.openai.com/codex/app/commands)