evolve agent

Install script
Agent directory

evolve agent add my-agent \
  --install-script ./install.sh \
  --run "my-agent --headless"

Evolve uploads the script’s contents.

evolve agent add my-agent \
  --dir ./my-agent \
  --run "./bin/my-agent --headless" \
  --agent-env MODE=eval

Evolve uploads the directory as an archive.

Use exactly one source. Both forms require --run. The result includes the registered name. Use that name with evolve run -a.

Registration options

Option	Meaning
`--install-script <path>`	Local install script.
`--dir <path>`	Local agent directory.
`--run <command>`	Required command, executed with `sh -c`.
`--agent-env <KEY=VALUE>`, `--ae <KEY=VALUE>`	Runtime environment variables. Repeatable.
`--org <name>`	Owning organization; otherwise the saved CLI default, then personal.

The registration belongs to you and an organization. Its members can use it in jobs; only you can change or remove it. For the execution contract and model access, see Agents.

List and inspect

evolve agent list --scope org
evolve agent show my-agent --json

agent list accepts --scope <my|shared|org> and all shared list options. agent show takes the registered agent’s name. This group manages custom registrations; it is not the list of built-in harnesses.

Run it

evolve run \
  -d deepswe@1.1 -i anko-default-function-arguments \
  -a my-agent -m gpt-6-luna \
  --max-trial-spend 1 --max-retries 0 \
  --watch

The supplied model must be suitable for your agent’s implementation.

Remove a registration

evolve agent remove my-agent

Past jobs keep their recorded agent configuration. Removal has no CLI confirmation prompt. With --json, add and show return one agent record, list returns a page, and remove returns name and deleted: true. See exit codes for failures. Global options apply. The plural agents is reserved; use agent.

Start work

Inspect results

Manage resources

Registration options

List and inspect

Run it

Remove a registration