observal-advanced

# Observal Advanced Operations ## Procedure: Reconcile Sessions Push local session JSONL to server for full trace context. Normally automatic via hooks. Manual recovery for all detected harnesses: ```bash observal reconcile ``` Target one harness or shorten the discovery window when needed: ```bash observal reconcile --harness claude-code --since 24 ``` --- ## Procedure: Self-Manage CLI ```bash observal self status observal self upgrade --force observal self upgrade --version 2.5.0 --force observal self downgrade --list observal self downgrade --version 2.4.0 --force observal self rollback ``` Use `--force` when running upgrades or downgrades from an agent so the command is non-interactive. --- ## Procedure: Uninstall Completely removes Observal. **Destructive and irreversible.** ```bash observal self uninstall ``` Requires typing `confirm` (not `--yes`). Selective flags: - `--keep-config`: preserve `~/.observal/` - `--keep-cli`: keep the CLI binary - `--keep-repo`: keep the cloned repo - `--repo-dir PATH`: specify repo location --- ## Procedure: Local Fallback Mode Use **only** when a command exits with `Connection failed` or `Not configured`. | harness | User-scope path | Project-scope path | |---|---|---| | Claude Code | `~/.claude/agents/<name>.md` | `.claude/agents/<name>.md` | | Kiro | `~/.kiro/agents/<name>.json` | `.kiro/agents/<name>.json` | | Cursor | `~/.cursor/rules/<name>.mdc` | `.cursor/rules/<name>.mdc` | | VS Code | `~/.config/Code/User/agen...