---

Installation

``bash
bun install -g code-recall-tui
`

Usage

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
`

---

Screens

$3

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

$3

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

$3

Full view of a single memory including:
- Category and outcome status
- Content, rationale, and context
- Tags, file path, and recorded outcome

$3

Browse all active rules/guardrails with their trigger patterns and constraint counts.

$3

Full view of a rule showing:
- Trigger pattern
- Must Do constraints
- Must Not constraints
- Ask First questions

$3

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

$3

Full-text search across all memories using SQLite FTS5.

---

Keyboard Shortcuts

| 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 |

---

Requirements

- Bun v1.0 or higher
- An existing .code-recall/memory.db database (created by the code-recall MCP server)
- macOS: SQLite with extension support (via Homebrew: brew install sqlite)

---

How It Works

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.

---

License

MIT License - see LICENSE for details.