---
title: "coding.sh run · coding.sh docs"
description: "Run any agent command and capture the session. Every option of coding.sh run, from its own --help."
canonical: https://coding.sh/docs/cli/run
human_url: https://coding.sh/docs/cli/run
markdown_url: https://coding.sh/docs/cli/run.md
agents_url: https://coding.sh/agents.md
llms_url: https://coding.sh/llms.txt
updated: 2026-11-11
---

# coding.sh run

Run any agent command and capture the session. Every option of coding.sh run, from its own --help.

coding.sh run --help

```
coding.sh run [options] -- <CMD>...

  Run any agent command and capture the session

Arguments
  cmd           Command and arguments after --

Options
  -a, --agent <AGENT>  Agent id to record (default: wrapper)

Examples
  coding.sh run -- aider --message 'fix the tests'

Notes
  Exits with the command's exit code.
```

[All commands](https://coding.sh/docs/cli) · [Global options](https://coding.sh/docs/cli#global)

To set coding.sh up for a user, follow the agent workflow at [/agents.md](https://coding.sh/agents.md).