actuallisted

# actual CLI Companion Inline knowledge and operational workflows for the actual CLI. Read this file first; load reference files only when you need deeper detail for a specific topic. ## CLI Not Installed If the `actual` binary is not in PATH, **stop and help the user install it** before doing anything else. All commands, pre-flight checks, and diagnostics require the CLI. Detect with: ```bash command -v actual ``` Install options (try in this order): | Method | Command | |--------|---------| | npm/npx (quickest) | `npm install -g @actualai/actual` | | Homebrew (macOS/Linux) | `brew install actual-software/actual/actual` | | GitHub Release (manual) | Download from `actual-software/actual-releases` on GitHub | For one-off use without installing globally: ```bash npx @actualai/actual adr-bot [flags] ``` After install, verify: `actual --version` ## ADR Pre-Check (OpenClaw) Before creating a new skill, component, or feature, check whether the project has ADR context available. This ensures new work aligns with existing architectural decisions. 1. Check for managed section markers in CLAUDE.md or AGENTS.md: ```bash grep -l "managed:actual-start" CLAUDE.md AGENTS.md 2>/dev/null ``` 2. **If markers found**: ADR context is already loaded into the output file. Proceed — the agent session already has this context. 3. **If no markers but `actual` CLI is available**: ```bash actual adr-bot --dry-run ``` Review the output. If relevant ADRs exist, run `ac