ctxrs / ctx

项目摘要

ctx is a Rust-based CLI tool that indexes and searches your local coding agent session history (Claude Code, Codex, Cursor, etc.) into a SQLite database, enabling fast, token-efficient retrieval of past decisions, failed attempts, and commands for current and future agent sessions.

为什么值得关注

It solves the 'agent amnesia' problem where coding agents start from zero each session, wasting tokens and repeating past mistakes. By structuring agent history into a searchable local index, it provides 50x token efficiency over raw transcript search while keeping data private and local.

优势

• Significant token efficiency improvement (50x) over raw transcript search
• Local-first, private by default with no background service required
• Supports multiple coding agent providers (Claude Code, Codex, Cursor)
• Fast performance via Rust and SQLite with scriptable CLI interface
• Active development with 17 releases in 6 months

局限性

• No CI/CD pipeline configured
• Limited documentation examples and no Docker support
• Very small contributor base (2 contributors)
• New project with limited production track record

使用场景

• Retrieving past architectural decisions and constraints before starting new agent sessions
• Finding previous failed approaches to avoid repeating mistakes
• Searching for specific commands or file paths from earlier debugging sessions
• Building context for new team members by surfacing historical agent interactions