Skip to main content
Every command supports --agent for structured JSON output. Use --agent instead of --json for consistent machine-readable output across all commands. 
oobo <any-command> --agent    # JSON output for any command

​
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          # JSON output
oobo a --agent -n 5           # short alias + options
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), transparency_mode

​
oobo sessions

Browse AI chat sessions. Without a subcommand or --agent, opens the interactive TUI.

​
sessions list

oobo sessions                         # interactive TUI for current project
oobo sessions --all                   # TUI for all projects
oobo sessions --agent                 # JSON output (current project)
oobo sessions list --agent            # same (explicit subcommand)
oobo sessions list --agent --all      # all projects, JSON
oobo sessions list --agent --tool cursor -n 10  # filter by tool, 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

​
sessions show

oobo sessions show <id>               # full conversation (prefix match)
oobo sessions show <id> --agent       # JSON with messages array
JSON fields: All list fields plus messages[] (each with role, text, timestamp_ms) and message_count 
oobo sessions search "auth bug"           # search current project
oobo sessions search "auth bug" --all     # search all projects
oobo sessions search "auth" --agent       # JSON 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)

​
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 a subcommand or --agent, opens the interactive TUI. 
oobo projects                         # interactive TUI
oobo projects --agent                 # JSON output
oobo projects list --agent            # same (explicit subcommand)
oobo projects show myapp --agent      # project details + sessions
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                    # global stats (JSON)
oobo stats --project myapp --agent    # per-project
oobo stats --tool cursor --agent      # per-tool
oobo stats --since 7d --agent         # last 7 days
oobo stats --since 2026-02-01 --agent # since a specific date
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. A shareable overview of your AI tool usage, sessions, tokens, models, and code attribution. No project names or private data included. 
oobo card                             # generate PNG infographic
oobo card --format png                # same (explicit)
oobo card --format svg                # SVG output
oobo card --format md                 # markdown output
oobo card --format json               # JSON output
oobo card --out dev.svg               # save to custom path
oobo card --agent                     # JSON output (agent mode)
Includes: tool count, session count, token total, AI code percentage, top tools, top models, commit profile (commits/day, active days), weekly AI code trend, and “active since” date.

​
oobo sources

Show data source status and coverage for each AI tool. 
oobo sources                          # human-readable table
oobo sources --agent                  # JSON output
Displays which tools are detected, what data is available (sessions, transcripts, native tokens, API usage), and coverage status.

​
oobo dash

Show oobo configuration overview, active sessions, and server connection status. 
oobo dash                             # interactive TUI
oobo dash --agent                     # JSON output

​
oobo version

Show oobo version, git version, database location, and environment info. 
oobo version                          # human-readable
oobo version --agent                  # JSON output

​
oobo share

Share a session with secret redaction. 
oobo share <id>                       # preview redacted session
oobo share <id> --out session.json    # save to file
oobo share <id> --agent               # JSON output
When authenticated, running oobo share without --out uploads to the configured server and returns a shareable URL. All content is redacted before sharing using gitleaks patterns (with regex fallback). Secrets are replaced with [REDACTED]. Output format: 
{
  "session_id": "abc-123-456",
  "source": "composer",
  "model": "claude-sonnet-4",
  "messages": [
    { "role": "user", "text": "Add auth flow for..." },
    { "role": "assistant", "text": "I'll create the auth module..." }
  ],
  "stats": {
    "input_tokens": 5000,
    "output_tokens": 12000,
    "duration_secs": 120
  },
  "shared_at": "2026-03-04T12:00:00Z",
  "oobo_version": "0.1.0"
}

​
oobo inspect

Run diagnostics and auto-repair common issues. 
oobo inspect                          # colored pass/warn/fail output
oobo inspect --fix                    # auto-repair (install hooks, clean stale sessions)
oobo inspect --agent                  # machine-readable JSON
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 (returns immediately)
oobo index --status                   # check background indexing progress
Indexing is incremental by default. Only new or changed sessions are processed. Background indexing sends a desktop notification when complete.

​
oobo auth

Manage authentication and tool API keys.

​
Server authentication

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

​
Tool API keys

Store API keys for pulling remote usage data during oobo index: 
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

Toggle backend sync or import anchors from the orphan branch. 
oobo sync                             # show current sync status
oobo sync on                          # enable auto-sync (prompts for key/URL)
oobo sync off                         # disable auto-sync
oobo sync --import                    # import anchors from orphan branch into local DB
When sync is enabled and an API key is configured (OOBO_SECRET_KEY env var or server.api_key in config), anchor data is automatically pushed to the backend on every commit via POST /anchors/ingest. oobo sync --import is safe to run multiple times (idempotent). Useful after cloning a repo that has existing anchor history on the orphan branch.

​
oobo ignore / unignore

Opt out of oobo enrichment per repo. 
oobo ignore                           # ignore current repo
oobo ignore --list                    # show all ignored repos
oobo unignore                         # re-enable tracking

​
oobo update

Check for updates or self-update. 
oobo update                           # download and install latest
oobo update --check                   # just check, don't install

​
oobo agent

Print the skill file for AI agents. 
oobo agent
Outputs the contents of ~/.agents/skills/oobo/SKILL.md, a structured document that AI agents can read to discover oobo’s capabilities and invoke commands.

​
oobo alias

Manage the git→oobo shell alias. 
oobo alias install                    # add alias to shell RC
oobo alias uninstall                  # remove alias
Supports zsh, bash, and fish.