A terminal UI issue manager with Claude Code integration. Syncs with Linear, launches Claude sessions with rich issue context, captures transcripts, and summarizes them with pluggable LLM providers.
- Linear sync — background sync of issues, teams, projects, labels, and workflow states via GraphQL
- Issue management — browse, create, edit, filter by team/project/status, cycle statuses
- Claude Code integration — launch Claude sessions in a tmux pane with automatic context injection (issue details, past summaries, linked documents)
- Transcript capture — monitor Claude sessions and store raw transcripts
- LLM summarization — summarize transcripts with Claude API, OpenAI, or local Ollama
- Full-text search — FTS5-indexed search across issues, documents, and transcripts
- Document viewer — per-issue documents (PRDs, notes, plans, tasks)
- Offline-first — SQLite cache means the UI loads instantly and works without network
cargo install --path .# Set your Linear API key (stored in local DB)
ctxrec --linear-api-key lin_api_...
# Run (auto-bootstraps a tmux session)
ctxrec
# Or skip tmux and run the TUI directly
ctxrec --no-tmuxAll configuration is stored in a local SQLite database (~/.local/share/ctxrecall/ctxrecall.db).
| Flag | Description |
|---|---|
--linear-api-key KEY |
Set Linear API key (also reads LINEAR_API_KEY env) |
--set-project-dir "Name=/path" |
Map a Linear project to a local directory |
--set-team-dir "Name=/path" |
Map a Linear team to a local directory |
--set-llm-provider NAME |
Set LLM provider: claude, openai, or ollama |
--set-llm-api-key KEY |
Set LLM API key |
--set-llm-model MODEL |
Override default model |
--set-llm-ollama-url URL |
Set Ollama endpoint (default: http://localhost:11434) |
--no-tmux |
Skip tmux bootstrap |
When launching Claude for an issue, ctxrecall sets the working directory based on the issue's project or team:
ctxrec --set-project-dir "Backend=/home/user/repos/backend"
ctxrec --set-team-dir "Engineering=/home/user/repos/monorepo"| Key | Action |
|---|---|
j/k |
Move up/down |
Enter |
View issue detail |
n |
New issue |
e |
Edit issue |
s |
Cycle status |
f |
Filter by status |
t |
Filter by team |
p |
Filter by project |
c |
Launch Claude session |
T |
View transcripts |
d |
View documents |
r |
Refresh |
/ |
Search |
h |
Help |
Ctrl-r |
Cycle pane size |
Ctrl-s |
Settings |
Ctrl-p |
Command palette |
q |
Quit |
| Key | Action |
|---|---|
j/k |
Scroll |
e |
Edit issue |
s |
Cycle status |
n |
New issue |
c |
Launch Claude |
Tab |
Switch focus |
Esc |
Back to list |
ctxrecall ships with four built-in themes: dark (default), light, solarized, and gruvbox. Switch themes from Settings (Ctrl-s → Theme tab → Enter).
Create a theme.conf file in your config directory:
# macOS
~/.config/ctxrecall/theme.conf
# Linux
~/.config/ctxrecall/theme.conf # or $XDG_CONFIG_HOME/ctxrecall/theme.confThe file uses TOML format with hex color values:
name = "my-theme"
bg = "#1a1b26"
fg = "#c0caf5"
accent = "#7aa2f7"
selection = "#283457"
border = "#565f89"
error = "#f7768e"
success = "#9ece6a"
warning = "#e0af68"
muted = "#565f89"All nine color fields are required. Once the file is saved, "custom" appears in the theme list in Settings.
See docs/architecture.md for system diagrams, event flow, and database schema.
src/
├── main.rs # CLI parsing, startup, tmux bootstrap
├── app.rs # Main state machine & event loop
├── action.rs # Action enum (all state mutations)
├── event.rs # Terminal event handling
├── errors.rs # AppError types
├── tui.rs # Terminal setup/teardown
├── logging.rs # Tracing/log initialization
│
├── components/ # UI components (all impl Component trait)
│ ├── issue_list.rs # Main issue browser with filtering
│ ├── issue_detail.rs # Issue detail view
│ ├── issue_create.rs # Multi-step issue creation form
│ ├── issue_edit.rs # Issue edit form
│ ├── dashboard.rs # Stats panel
│ ├── search.rs # Full-text search overlay
│ ├── command_palette.rs # Quick action launcher
│ ├── settings.rs # Configuration panel
│ ├── filter_picker.rs # Team/project filter modal
│ ├── transcript_viewer.rs
│ ├── document_viewer.rs
│ ├── help_overlay.rs # Keyboard shortcut reference
│ └── status_bar.rs
│
├── widgets/ # Reusable UI primitives
│ ├── modal.rs # Modal dialog frame
│ ├── editable_field.rs # Text input with cursor
│ ├── fuzzy_list.rs # Fuzzy-filterable list
│ └── dropdown.rs # Dropdown selector
│
├── tracker/ # Issue tracker abstraction
│ ├── mod.rs # IssueTracker trait
│ ├── types.rs # Issue, Team, Project, Label, etc.
│ ├── linear.rs # Linear GraphQL client
│ └── sync.rs # Background sync manager
│
├── db/ # SQLite data layer
│ ├── mod.rs # Init + migration runner
│ ├── issue_repo.rs # Issue/team/project/label CRUD
│ ├── config_repo.rs # Key-value config store
│ ├── search_repo.rs # FTS5 search
│ ├── session_repo.rs # Claude session tracking
│ └── document_repo.rs # Per-issue documents
│
├── claude/ # Claude Code integration
│ ├── session.rs # Session lifecycle manager
│ ├── context.rs # Context prompt builder
│ └── transcript.rs # Transcript capture from tmux
│
├── llm/ # LLM summarization providers
│ ├── mod.rs # LlmProvider trait + factory
│ ├── claude_api.rs # Anthropic Claude
│ ├── openai.rs # OpenAI
│ ├── ollama.rs # Local Ollama
│ └── summarizer.rs # Periodic summarization task
│
├── tmux/ # Tmux integration
│ ├── mod.rs # Pane management & bootstrap
│ └── layout.rs # Layout helpers
│
└── config/ # Configuration
├── hotkeys.rs # Keyboard bindings
├── theme.rs # UI theme
└── toml_io.rs # TOML file I/O
migrations/ # SQLite schema (embedded at compile time)
├── 001_initial.sql # Config, accounts, hotkeys, themes
├── 002_issues.sql # Issues, teams, projects tables
├── 003_transcripts.sql # Claude sessions & transcripts
├── 004_fts.sql # Full-text search index
├── 005_issue_status_id.sql
├── 006_workflow_states.sql
├── 007_issue_team_id.sql
├── 008_issue_project_id.sql
├── 009_labels.sql
├── 010_issue_assignee_id.sql
└── 011_label_team_id.sql
MIT