Skip to content

tui

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

tui

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
src
src
 
 
CHANGELOG.md
CHANGELOG.md
 
 
README.md
README.md
 
 
package.json
package.json
 
 
tsconfig.json
tsconfig.json
 
 

README.md

code-recall-tui

Terminal UI for browsing your code-recall database

Explore memories, rules, code entities, and search through everything your AI agent has learned.

npm License: MIT Bun

Installation

bun install -g code-recall-tui

Usage

Run from the root of a project that has a .code-recall/memory.db file:

code-recall-tui

Or specify a project path:

code-recall-tui --project /path/to/your/project

You can also set the project path via environment variable:

CODE_RECALL_PROJECT_PATH=/path/to/project code-recall-tui

Screens

Dashboard

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

Memories

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

Memory Detail

Full view of a single memory including:

  • Category and outcome status
  • Content, rationale, and context
  • Tags, file path, and recorded outcome

Rules

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

Rule Detail

Full view of a rule showing:

  • Trigger pattern
  • Must Do constraints
  • Must Not constraints
  • Ask First questions

Code Entities

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

Search

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.