@vibecook/spaghetti

Inspect, search, and navigate Claude Code data from the terminal.

Part of Spaghetti. The CLI ships both a full-screen Ink TUI and one-shot commands. It indexes ~/.claude into local SQLite via @vibecook/spaghetti-sdk.

╭ Spaghetti v0.5.0 ──────────────────────────────────────────────────────╮
│                                                                        │
│  ▄▀▀ █▀█ ▄▀▄ █▀▀ █ █ █▀▀ ▀█▀ ▀█▀ █      Projects           79         │
│  ▀▄▄ █▀▀ █▀█ █ █ █▀█ █▀   █   █  █      Sessions        1,247         │
│  ▄▄▀ █   █ █ ▀▀▀ ▀ ▀ ▀▀▀  ▀   ▀  ▀      Messages       86,412         │
│                                            Tokens          66.3M      │
│  untangle your claude code history         ──────────────────────      │
│                                            /search  /stats  /help      │
╰────────────────────────────────────────────────────────────────────────╯

Install

npm install -g @vibecook/spaghetti
spag

Or run without installing:

npx @vibecook/spaghetti

Binaries: spaghetti and the shorter spag.

Modes

• Bare spag in a TTY launches the Ink TUI.
• spag --json or piped spag prints a JSON summary.
• Subcommands (projects, messages, search, …) run as one-off terminal commands.

TUI

Home
 ├─ Projects
 │   ├─ Sessions
 │   │   ├─ Messages
 │   │   ├─ Todos
 │   │   ├─ Plan
 │   │   └─ Subagents
 │   └─ Memory
 ├─ Hooks Monitor
 ├─ Stats
 ├─ Help
 ├─ Chat
 └─ Doctor

The TUI initializes the core service lazily and shows a boot screen with progress while the parser/indexer runs.

Commands

| Command | Alias | Purpose | |---|---|---| | projects | p | List indexed projects | | sessions [project] | s | List sessions for a project | | messages [project] [session] | m | Read session messages | | search <query> | | Full-text search | | stats | st | Aggregate usage and store stats | | memory [project] | mem | Show project MEMORY.md | | todos [project] [session] | t | Show session todos | | subagents [project] [session] [agent] | sub | Inspect subagent transcripts | | plan [project] [session] | pl | Show a session plan | | export [project] | x | Export project/session data (JSON or Markdown) | | hooks | h | View captured hook events | | chat | c | Chat with active Claude Code sessions | | plugin <action> [plugin] | | Install/uninstall/check Spaghetti plugins | | doctor | | Health-check data paths and plugin state | | update | | Check for and install updates | | uninstall | | Show uninstall instructions |

Flexible resolution

Project and session args accept:

• exact names
• fuzzy prefixes
• numeric indexes
• . for current working directory
• latest / last for the newest session
• partial UUIDs for session selection

Examples

spag projects
spag sessions .
spag messages . latest
spag search "refactor parser"
spag export . --format markdown --output session.md
spag hooks --follow
spag chat --follow
spag doctor

Requirements

• Node.js >=18
• A local Claude Code data directory at ~/.claude

Library usage

If you want to build on top of the same data pipeline, use @vibecook/spaghetti-sdk directly.

License

MIT — James Yong