Skip to main content

​
Output modes

Every command supports two global flags for structured output:
FlagOutputDescription
--agentCompact textPipe-delimited rows for lists, key: value for single objects. Minimal tokens.
--jsonFull JSONComplete object graph for scripts and programmatic use.
The flags are mutually exclusive and work on any command at any position. Examples throughout this page show --agent; replace with --json for full JSON.

​
Git passthrough

Oobo proxies all standard git commands. Read operations pass through with zero overhead. Write operations (commit, push, merge, rebase, cherry-pick, etc.) trigger anchor creation. 
oobo status              # git status
oobo log --oneline -5    # git log --oneline -5
oobo diff                # git diff
oobo commit -m "msg"     # git commit + anchor creation
oobo push origin main    # git push + orphan branch sync
Any unrecognized command is forwarded to git.

​
oobo setup

Interactive setup wizard. Detects AI tools, configures session sync, cloud connection, git alias, and installs hooks. 
oobo setup

​
oobo anchors

Show enriched commit history with anchor metadata. 
oobo anchors                  # colored human-readable output
oobo anchors -n 20            # last 20 commits
oobo anchors --agent          # compact output
oobo a --agent -n 5           # short alias
JSON fields: commit_hash, message, author, author_type, branch, committed_at, contributors[] (each with name, role, model), files_changed[], added, deleted, file_changes[] (each with path, added, deleted, attribution, agent), ai_added, ai_deleted, human_added, human_deleted, ai_percentage, sessions[] (each with session_id, agent, model, link_type, files_touched[], is_subagent, is_estimated, parent_session_id?, subagent_type?, peer_session_ids[]), transparency_mode, file_interactions[]? (each with path, sessions[] of {session_id, role})

​
oobo sessions

Browse AI chat sessions. Without flags, opens the interactive TUI.

​
sessions list

oobo sessions                         # interactive TUI for current project
oobo sessions --all                   # TUI for all projects
oobo sessions list --agent            # compact output (current project)
oobo sessions list --agent --all      # all projects
oobo sessions list --agent --tool cursor -n 10  # filter + limit
JSON fields: session_id, name, source, mode, project_path, created_at, updated_at, model, input_tokens, output_tokens, duration_secs, is_estimated, files_touched, tool_calls, parent_session_id?, subagent_type?, peer_session_ids[]?

​
sessions show

oobo sessions show <id>               # full conversation in TUI (prefix match)
oobo sessions show <id> --agent       # compact summary (no messages)
oobo sessions show <id> --json        # full JSON with messages array
Note: --agent omits the messages array for compactness. Use --json when you need the full conversation. JSON fields: All list fields plus messages[] (each with role, text, timestamp_ms), message_count, and peer_session_ids[]? 
oobo sessions search "auth bug"           # search current project
oobo sessions search "auth bug" --all     # search all projects
oobo sessions search "auth" --agent       # compact output
oobo sessions search "auth" -n 50         # limit results (default: 20)
Searches session name, first message, and transcript content. JSON fields: All session fields plus matched_on (name or first_message) and peer_session_ids[]?

​
sessions export

oobo sessions export <id> --format md              # markdown to stdout
oobo sessions export <id> --format md --out chat.md # markdown to file
oobo sessions export <id> --format json --out s.json # JSON to file

​
oobo projects

Browse and manage discovered projects. Without flags, opens the interactive TUI. 
oobo projects                         # interactive TUI
oobo projects --agent                 # compact output
oobo projects show myapp --agent      # project summary
oobo projects forget myapp            # remove from tracking
JSON fields: id, name, path, tools, sessions, input_tokens, output_tokens

​
oobo stats

Token usage analytics, AI code attribution, and productivity metrics. 
oobo stats                            # global stats (human)
oobo stats --agent                    # compact stats
oobo stats --project myapp --agent    # per-project
oobo stats --tool cursor --agent      # per-tool
oobo stats --since 7d --agent         # last 7 days
JSON fields: sessions, input_tokens, output_tokens, total_tokens, per_tool[], per_model[], ai_code, productivity, daily[]

​
oobo card

Generate your AI-first developer stats card. 
oobo card                             # generate PNG infographic
oobo card --format svg                # SVG output
oobo card --format md                 # markdown output
oobo card --format json               # JSON output (card-specific flag)
oobo card --out dev.svg               # save to custom path
oobo card --agent                     # compact stats summary
Includes: tool count, session count, token total, AI code percentage, top tools, top models, commit profile, and “active since” date.

​
oobo sources

Show data source status and coverage for each AI tool. 
oobo sources                          # human-readable table
oobo sources --agent                  # compact output

​
oobo dash

Show oobo configuration overview, active sessions, and server connection status. 
oobo dash                             # interactive TUI
oobo dash --agent                     # compact key: value output

​
oobo version

oobo version                          # human-readable
oobo version --agent                  # compact key: value output

​
oobo share

Share a session with secret redaction. 
oobo share <id>                       # upload to server, get shareable URL
oobo share <id> --out session.md      # save as markdown
oobo share <id> --out session.json    # save as JSON
oobo share <id> --agent               # compact response
Without --out, uploads to your configured server and returns a shareable URL. Auth is optional. With --out, format is determined by extension: .json/.jsonl → JSON, anything else → markdown. Local saves never touch the network. All content is redacted using gitleaks patterns before sharing.

​
oobo inspect

Run diagnostics and auto-repair common issues. 
oobo inspect                          # colored pass/warn/fail output
oobo inspect --fix                    # auto-repair
oobo inspect --agent                  # compact output
Checks: config file, database, git alias, git hooks, agent hooks, stale sessions, tool availability.

​
oobo scan

Discover projects and sessions from all enabled AI tools. 
oobo scan                             # scan everything
oobo scan --project /path/to/repo     # scan a specific project
oobo scan --agent                     # suppresses interactive output

​
oobo index

Compute token counts and analytics for discovered sessions. 
oobo index                            # index all sessions (incremental)
oobo index --project myapp            # index a specific project
oobo index --force                    # re-index already indexed sessions
oobo index --bg                       # run in background
oobo index --status                   # check background progress

​
oobo auth

Manage authentication and tool API keys. 
oobo auth login --key <api_key>       # authenticate
oobo auth login                       # interactive prompt
oobo auth logout                      # remove credentials
oobo auth status                      # show auth state + configured keys
oobo auth set-remote https://oobo.mycompany.com  # self-hosted server

​
Tool API keys

oobo auth anthropic <key>             # Anthropic Admin API key
oobo auth openai <key>                # OpenAI API key
oobo auth copilot <token>             # GitHub Copilot org PAT
oobo auth windsurf <key>              # Windsurf/Codeium service key
oobo auth google <key>                # Google AI Studio API key

​
oobo sync

oobo sync                             # show current sync status
oobo sync on                          # enable auto-sync
oobo sync off                         # disable auto-sync
oobo sync --import                    # import anchors from orphan branch into local DB

​
oobo update

oobo update                           # download latest + run post-update migrations
oobo update --check                   # just check, don't install
After updating, oobo automatically refreshes the skill file, applies pending DB migrations, and re-installs agent hooks.

​
oobo agent

Print the skill file for AI agents. 
oobo agent

​
oobo alias

oobo alias install                    # add alias to shell RC
oobo alias uninstall                  # remove alias

​
oobo ignore / unignore

oobo ignore                           # ignore current repo
oobo ignore --list                    # show all ignored repos
oobo unignore                         # re-enable tracking