observal-agents

# Observal Agents: Agent Lifecycle Management ## Critical Rules 1. **EXECUTE commands**: run them in your shell. Set timeout to 60 seconds. 2. **Use single quotes** for `--prompt` and `--description` values. 3. **Pass `--output json`** on list/show/versions commands. 4. **Pass `--yes`** on destructive commands (`archive`, `delete`, `unarchive`, `bulk-create`). 5. **Resolve 409:** `observal agent publish --update` for in-place edits, `observal agent release --bump` for reviewed releases. 6. **When in doubt about a flag, run `<command> --help` first.** --- ## Procedure: Create Agent Required: `--name`, `--description`, `--prompt`. Optional: `--model`, `--harness` (repeatable), `--prompt-file`, `--from-file`. Before choosing a model, query the registry for every selected harness and pick an available exact model: ```bash observal registry models --harness kiro --output plain observal registry models --harness claude-code --output plain ``` > **WARNING:** Without `--name` and `--prompt`, the command launches an interactive wizard. Always pass at least `--name`, `--description`, and `--prompt`. ```bash observal agent create \ --name AGENT_NAME \ --description 'Short description' \ --prompt 'System prompt content' \ --model claude-sonnet-4-6 \ --harness kiro --harness claude-code ``` Error branching: - **`409`**: switch to Procedure: Update Agent or Release Agent Version. - **`422`**: missing required field. Check message, fix, retry. - **`Connection failed`**: ...