cd briefcase
pip install -e .

export ANTHROPIC_API_KEY=sk-ant-...

briefcase init      # Set up .briefcase/ in this project
briefcase scan      # Scan and summarize all significant files
briefcase export    # Copy-paste context into your AI chat

briefcase scan / update
        │
        ▼
   scanner.py ──► walks project, detects tech stack, skips junk
        │
        ▼
  git_tracker.py ──► finds changed files since last scan
        │
        ▼
  summarizer.py ──► Claude API (or heuristics) per file
        │
        ▼
   storage.py ──► SQLite in .briefcase/briefing.db
        │
        ▼
   exporter.py ──► paste-ready markdown context block

your-project/
└── .briefcase/
    ├── briefing.db    # SQLite — summaries, notes, history
    └── config.json    # Tech stack, settings

briefcase serve

{
  "mcpServers": {
    "briefcase": {
      "command": "briefcase",
      "args": ["serve"],
      "cwd": "/path/to/your/project"
    }
  }
}

# First time in a project
briefcase init
briefcase scan

# After coding for a while
briefcase update
briefcase export -o CONTEXT.md

# Remember why you made a choice
briefcase note "Chose SQLite over Postgres — single-user, no server needed" -f briefcase/storage.py
briefcase notes

# Before switching AI tools
briefcase diff
briefcase status

pip install -e ".[dev]"
pytest

briefcase/
├── briefcase/
│   ├── cli.py           # CLI commands
│   ├── scanner.py       # Project walker + tech stack detection
│   ├── summarizer.py    # Claude API / heuristic summaries
│   ├── git_tracker.py   # Git diff integration
│   ├── storage.py       # SQLite persistence
│   ├── notes.py         # Decision notes
│   ├── exporter.py      # Paste-ready export
│   └── mcp_server.py    # MCP server mode
├── tests/
├── pyproject.toml
└── README.md