Dashboard

ctxfile ui starts a local dashboard: a cockpit for snapshots, the captured context, and Pro features. It is a viewer and control surface over the same engine the MCP server uses; agents never need it.

Starting it

ctxfile ui                # opens your browser
ctxfile ui --no-open      # just prints the URL
ctxfile ui --port 5000    # explicit port (default 4747)

The printed URL carries a one-time access token in the URL fragment. Open the dashboard through that URL; a bare http://127.0.0.1:4747 is refused. The server binds to 127.0.0.1 only, sends a strict Content-Security-Policy, and is never reachable from your network.

Views

View	What it shows
Overview	Run snapshots and watch them live: each connector lights up as it starts and finishes (streamed over SSE), the token meter fills against the budget, and recent snapshots chart their token usage. Stats: tokens used, key files, redactions, snapshot age (flags stale).
Context	The captured ContextObject as a browsable tree: plan, every key file with its token count and redactions, git state, Notion pages, sessions. Scope switch (full / plan / files / git), raw JSON view, and “Copy as agent payload”.
Git	Staged / modified / untracked columns, recent commits, and the diff summary.
Sessions (Pro)	Claude Code and Cursor session digests, with source, turn count, and last activity.
Memory (Pro)	Every memory entry grouped by the agent that wrote it, with provenance and timestamps. Filter, and forget (permanently delete) any entry behind a confirmation.
Consult (Pro)	Ask your configured providers a question; answers stream in side-by-side columns.
Settings	The network gauge (how many remote opt-ins are enabled; 0 means fully local), resolved configuration, connector status, license activation and feature flags, and the privacy defaults.

Keyboard

Key	Action
R	Run a snapshot.
⌘K / Ctrl+K	Command palette: jump to any view, run a snapshot, switch theme.
Esc	Close palettes and dialogs.

License activation

Paste a Pro key into Settings → License (or run ctxfile activate <key>). Verification is local Ed25519; the tier, expiry, and per-feature flags render immediately. See Pro.

Behavior worth knowing

Snapshot runs are single-flight: pressing R during a run does not queue a second build.
If the ctxfile ui process dies, the page shows a “server unreachable” overlay and reconnects automatically when you restart it.
Dark and light themes; the toggle lives in the top bar and persists.