Terminal UI for browsing code-recall memories, rules, and code entities
npm install code-recall-tuiTerminal UI for browsing your code-recall database
Explore memories, rules, code entities, and search through everything your AI agent has learned.



---
``bash`
bun install -g code-recall-tui
Run from the root of a project that has a .code-recall/memory.db file:
`bash`
code-recall-tui
Or specify a project path:
`bash`
code-recall-tui --project /path/to/your/project
You can also set the project path via environment variable:
`bash`
CODE_RECALL_PROJECT_PATH=/path/to/project code-recall-tui
---
Overview of your code-recall data at a glance:
- Total memories, rules, failed decisions, and warnings
- Category breakdown (decisions, patterns, warnings, learnings)
- Recent activity feed
- Failed approaches panel
Browse all stored memories with category filtering:
- Filter by: All, Decisions, Patterns, Warnings, Learnings
- Navigate tabs with [ and ]
- Press Enter to view full memory details
Full view of a single memory including:
- Category and outcome status
- Content, rationale, and context
- Tags, file path, and recorded outcome
Browse all active rules/guardrails with their trigger patterns and constraint counts.
Full view of a rule showing:
- Trigger pattern
- Must Do constraints
- Must Not constraints
- Ask First questions
Browse analyzed source files and their extracted code structure:
- Split view: file list + entity details
- Color-coded entity types (classes, functions, interfaces, etc.)
- Signatures and line ranges
Full-text search across all memories using SQLite FTS5.
---
| Key | Action |
|-----|--------|
| 1 | Go to Dashboard |2
| | Go to Memories |3
| | Go to Rules |4
| | Go to Code Entities |/
| | Go to Search |Escape
| | Go back |Enter
| | Select / Open detail |Tab
| | Toggle panel focus (where applicable) |[
| / ] | Switch tabs (Memories screen) |q
| | Quit |
---
- Bun v1.0 or higher
- An existing .code-recall/memory.db database (created by the code-recall MCP server)brew install sqlite
- macOS: SQLite with extension support (via Homebrew: )
---
code-recall-tui opens your .code-recall/memory.db` database in read-only mode -- it never modifies your data. It's a standalone viewer that is completely independent from the code-recall MCP server.
---
MIT License - see LICENSE for details.