> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-ade-mobile-chat-stability-54bd7ef0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Run

> Start dev processes, run tests, and keep project health visible.

Run is the project control room. Use it to start the app stack, watch process output, run tests, and check whether the project is ready for agent work.

<CardGroup cols={3}>
  <Card title="Processes" icon="server">
    Start, stop, restart, and inspect dev servers or background commands.
  </Card>

  <Card title="Tests" icon="vial">
    Run known validation commands without leaving ADE.
  </Card>

  <Card title="Health" icon="heart-pulse">
    See crashes, logs, ports, and CI signals in one place.
  </Card>
</CardGroup>

## Add a process

<Steps>
  <Step title="Open Run">
    Choose **Run** from the sidebar.
  </Step>

  <Step title="Add process">
    Give the command a name, working directory, and command line.
  </Step>

  <Step title="Start it">
    ADE opens a managed session, streams logs, and tracks status.
  </Step>

  <Step title="Use it from a lane">
    Agents can inspect logs or run tests against the same project state.
  </Step>
</Steps>

## Good process examples

| Name      | Command             |
| --------- | ------------------- |
| Web app   | `npm run dev`       |
| API       | `npm run dev:api`   |
| Tests     | `npm test`          |
| Typecheck | `npm run typecheck` |

## When agents use Run

Run gives agents a shared view of what is already running. A chat agent can ask for test output, inspect logs, or start a configured command instead of inventing a new one.

<Note>
  Processes run on your machine. Make sure commands are safe before saving shared project defaults.
</Note>