observal-advanced

# Observal Advanced Operations ## Procedure: Reconcile Sessions Push local session JSONL to server for full trace context. Normally automatic via hooks. Manual run for crash recovery: ```bash python -m observal_cli.cmd_reconcile ``` Not a Typer command. No flags needed. --- ## Procedure: Self-Manage CLI ```bash observal self status observal self upgrade observal self upgrade --version 2.5.0 observal self downgrade --list observal self downgrade --version 2.4.0 observal self rollback ``` --- ## 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`. | IDE | 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` | | Gemini CLI | `~/.gemini/agents/<name>.md` | `.gemini/agents/<name>.md` | | VS Code | `~/.config/Code/User/agents/<name>.md` | `.vscode/agents/<name>.md` | | Codex CLI | `~/.codex/agents/<name>.md` | `.codex/agents/<name>.md` | | Copilot CLI | `~/.co...