observal

# Observal: Core CLI Operations ## Critical Rules 1. **EXECUTE commands**: run them in your shell, do not just display them. 2. **Set timeout to 60 seconds**: most commands make HTTP calls. 3. **Use single quotes** for `--prompt` and `--description` values to avoid shell quoting issues. 4. **Do NOT run `observal auth status` first.** Other commands surface auth problems clearly on their own. 5. **When in doubt about a flag, run `<command> --help` first.** Never guess flag names. 6. **Pass `--output json` on every list/show command.** It is stable and machine readable. 7. **Pass `--yes` / `-y` on destructive commands** so they do not block on a confirmation prompt. 8. **Resolve 409 conflicts deterministically:** `--update` for in-place edits, `--bump` for versioned releases. 9. **Only fall back to local file writes** if a command exits with `Connection failed` or `Not configured`. 10. **Never invent `OTEL_*` or `CLAUDE_CODE_ENABLE_TELEMETRY` environment variables.** Telemetry flows through `observal-shim` and session push hooks only. --- ## Procedure: Pull Agent Install an agent's full config (rules, MCP servers, hooks, skills) into a local IDE. ```bash observal agent pull AGENT_NAME --ide kiro --no-prompt --dir . ``` **Flags:** - `--ide` (required): `claude-code`, `kiro`, `cursor`, `gemini-cli`, `vscode`, `codex`, `copilot`, `copilot-cli`, `opencode` - `--scope user|project`: install scope (Claude Code, Kiro, Gemini only) - `--model <name>` or `--model <ide>=<name>`: o...