testy-claw run
Execute a task using the agent. Pass a plain-English description and the agent handles the rest.
Usage
terminal
testy-claw run <task> [options]Arguments
| Argument | Required | Description |
|---|---|---|
| task | Yes | Plain-English description of what to do |
Options
| Flag | Default | Description |
|---|---|---|
| --context <file> | — | Extra file(s) to include in the agent context |
| --model <id> | config | Override the model for this run |
| --max-steps <n> | config | Override maxSteps for this run |
| --dry-run | false | Plan only — do not execute any steps |
| --verbose | false | Print each step as it executes |
| --no-log | false | Skip writing the run log to disk |
| --output <file> | — | Write the final agent response to a file |
Examples
terminal
# Basic task
testy-claw run "add JSDoc comments to all functions in src/"
# With extra context
testy-claw run "refactor auth module" --context src/auth.ts
# Dry run — see the plan without executing
testy-claw run "delete all .log files" --dry-run
# Override model for one run
testy-claw run "write unit tests" --model claude-3-5-sonnet
# Verbose output
testy-claw run "scaffold a REST API" --verboseTipAlways use
--dry-run first when running destructive tasks like deleting files or pushing to Git.Exit codes
| Code | Meaning |
|---|---|
| 0 | Task completed successfully |
| 1 | Task failed |
| 2 | maxSteps reached |
| 3 | Tool timeout |