> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oobo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Developer memory - gives every commit context about which AI wrote what

# What is oobo?

Oobo is a **developer memory tool**. It sits beside git and gives every commit context about which AI wrote what, how many tokens it took, and what the agent was thinking.

It is not a git wrapper. You run `git` for git things. You run `oobo` for memory things.

## The Problem

Your team uses AI coding tools every day - Cursor, Claude Code, Copilot, Codex, Gemini - but once the code is committed, all context is lost. Six months later, nobody knows:

* Which lines were AI-generated
* What conversation produced them
* How much it cost
* Who approved it

## The Solution: Anchors

An **anchor** is oobo's core primitive. It extends a git commit with AI context:

```
Git commit  =  diff + message + author + timestamp
Anchor      =  commit + sessions + tokens + attribution
```

Each anchor records:

* Which AI sessions contributed to the commit
* Token counts (input, output, cache)
* Code attribution (AI vs human lines, per-file and per-line)
* Model used and session duration
* Tool calls, subagent activity, and thinking time

Anchors live on a git orphan branch (`oobo/anchors/v2`) that travels with the repo. No external dependencies, no cloud required.

## How It Works

```
You commit normally:  git commit -m "fix auth middleware"

  1. Post-commit hook fires automatically
  2. Oobo reads active AI sessions from local tool storage
  3. Builds an anchor: commit + sessions + tokens + attribution
  4. Writes anchor to the git orphan branch
  5. On push, anchor data travels with your code
```

Git operations work exactly as before. Oobo captures context via hooks, never by wrapping git.

## What You Can Do With It

```bash theme={null}
oobo                            # scrollable feed of enriched commits
oobo blame src/main.rs          # git blame + who (AI/human) wrote each line
oobo search "auth bug"          # semantic code search
oobo recall "auth bug"          # search sessions and memory
oobo sessions                   # list active and recent AI sessions
oobo session <id>               # drill into a session's turns and tokens
oobo delta                      # what changed since the last anchor
oobo goto <turn>                # time-travel to any point in a session
```

## What It Is (and Isn't)

| oobo is | oobo is not |
| - | - |
| A standalone binary alongside git | A git wrapper or alias |
| A git-native metadata store (orphan branch) | A cloud-first SaaS |
| A 15-tool observer (passive, read-only) | A plugin for any specific editor |
| Zero-config (auto-detects tools on commit) | Something that requires scanning or indexing |

## Supported Tools

| Tool | Sessions | Transcripts | Tokens | Hooks |
| - | :-: | :-: | :-: | :-: |
| Cursor | ✓ | ✓ | estimated | ✓ |
| Claude Code | ✓ | ✓ | native | ✓ |
| Gemini CLI | ✓ | ✓ | native | ✓ |
| OpenCode | ✓ | ✓ | native | ✓ |
| Codex CLI | ✓ | ✓ | native | - |
| Aider | ✓ | ✓ | native\* | - |
| GitHub Copilot | ✓ | ✓ | estimated | - |
| Zed | ✓ | ✓ | native | - |
| Continue | ✓ | ✓ | estimated | ✓ |
| Factory Droid | ✓ | ✓ | estimated | ✓ |
| Windsurf | ✓ | - | - | - |
| Trae | ✓ | - | - | - |
| Amp | ✓ | ✓ | estimated | - |
| Junie | ✓ | ✓ | estimated | - |
| Kiro | ✓ | ✓ | estimated | ✓ |

All integrations are **read-only** for session data - oobo never modifies any tool's conversation history. During setup, it writes hook configs to tool settings files.

**Native** = tool stores exact token counts. **Estimated** = oobo calculates via tiktoken (marked with `is_estimated: true`).

\*Aider native tokens require user configuration (see [Tool Integrations](/tool-integrations)).

## Architecture

* **Local-first**: Config in `~/.oobo/`, anchors on the orphan branch. Metadata travels only where your code already goes (your git remote).
* **Read-only data access**: Never modifies AI tool conversation history. Writes hook configs during setup.
* **Zero-config**: Tool detection is automatic on every commit.
* **Three output modes**: Pretty (TUI), `--agent` (token-efficient text), `--json` (structured).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.