> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolvingmachines.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# evolve agent

> Register and manage your own agents.

```bash theme={null}
evolve agent <command> [options]
```

## agent list

```bash theme={null}
evolve agent list [options]
```

List your registered agents.

<ParamField path="-l, --limit" type="n">
  Page size.
</ParamField>

<ParamField path="--cursor" type="c">
  Resume from a page cursor.
</ParamField>

<ParamField path="--columns" type="keys | all | help">
  Choose and order columns, comma-separated. `help` lists the keys.
</ParamField>

<ParamField path="-q, --quiet">
  Print only ids, one per line, for piping.
</ParamField>

<ParamField path="--no-trunc">
  Full cell content instead of one-line truncation.
</ParamField>

<ParamField path="--no-headers">
  Omit the header row in piped (TSV) output.
</ParamField>

## agent show

```bash theme={null}
evolve agent show <name>
```

Show one registered agent.

## agent add

```bash theme={null}
evolve agent add <name> [options]
```

Register an agent from an install script or a local directory.

<ParamField path="--install-script" type="path">
  Install script file. Its contents are uploaded.
</ParamField>

<ParamField path="--dir" type="path">
  Local agent directory, tarred and uploaded.
</ParamField>

<ParamField path="--run" type="command" required>
  Run command, executed with `sh -c`.
</ParamField>

<ParamField path="--ae, --agent-env" type="KEY=VALUE">
  Environment injected at run time. Repeatable. It may not override the six run-contract keys, and a credential-shaped key is refused, both with `agent_invalid_env`; see [the run contract](/core-concepts/agents#the-run-contract).
</ParamField>

```bash theme={null}
evolve agent add acme-cli --install-script ./install.sh --run "acme-cli --headless"
```

## agent remove

```bash theme={null}
evolve agent remove <name>
```

Delete a registered agent. Past jobs keep their record.

## Global options

<ParamField path="--json">
  Machine-readable JSON output.
</ParamField>

<ParamField path="--api-key" type="key">
  API key. Defaults to `$EVOLVE_API_KEY`.
</ParamField>

<ParamField path="--base-url" type="url">
  API base URL. Defaults to the Evolve dashboard API.
</ParamField>