TUI Guide

Memory Layer's TUI is the fastest way to browse project memory, ask cited questions, monitor live agents, switch embedding backends, get back into flow after an interruption, and inspect what the backend has been doing.

What Makes It Useful

Query answers show citations, confidence, diagnostics, and the ranked memories behind the answer.
Agents and Watchers show live distributed agent state, token pressure, context usage, rate limits, heartbeats, and recovery behavior.
Embeddings shows every configured backend and per-project coverage so model switching is visible instead of hidden in config files.
Activity and Resume turn persisted operations into get-up-to-speed context for new or returning agents.
Memories and Review keep the durable knowledge base readable and maintainable.

Layout

Every TUI screen uses the same four-part layout:

the top tab bar
the controls row for the active tab
the main content area
the bottom status/footer area with TUI, service, watcher, and on Linux the watcher-manager state

Shared navigation:

Tab, Right, or l moves to the next tab
Shift+Tab, Left, or h moves to the previous tab
r refreshes the project state
Ctrl+C exits the TUI

Tabs

Memories Tab
- Browse the canonical memory list, filter it, and inspect one memory entry in detail.
Agents Tab
- Monitor live Codex and Claude sessions across projects with token, context, rate-limit, process, and port details.
Query Tab
- Ask a question against project memory and inspect the ranked results.
Activity Tab
- Review persisted activity history and generate get-up-to-speed briefings for new or returning agents.
Project Tab
- Inspect project-level health, counts, embedding state, recent activity, and automation status.
Review Tab
- Work the queue of pending replacement proposals: approve, reject, or change the curation replacement policy.
Watchers Tab
- See active watchers, heartbeat state, restart attempts, and watcher recovery details.
Embeddings Tab
- List configured embedding backends, see their per-project coverage, and activate a different backend without leaving the TUI.
Resume Tab
- Use this after an interruption to get the current work thread, suggested next step, and recent timeline.

Where To Start

If you want to inspect or filter stored memory, open Memories Tab.
If you want to ask a question directly, open Query Tab.
If you want a new-agent briefing or persisted operational history, open Activity Tab.
If you want to watch active coding-agent sessions across projects, open Agents Tab.
If you want high-level health or recent operational activity, open Project Tab; for pending-proposal review, open Review Tab.
If you want watcher liveness and watchdog status, open Watchers Tab.
If you want to see which embedding backends are configured and switch which one search uses, open Embeddings Tab.
If you are returning after time away, open Resume Tab for the re-entry briefing.