Dashboard & TUI

Canopy is Rift’s terminal dashboard. Use it to move between projects, follow agent work, and review captured sessions.

# Open the dashboard

terminal
rift
rift --ascii
rift --skip-splash

Run rift in your project. Use --ascii for a simpler renderer if your terminal does not display the full interface correctly. Use --skip-splash to go straight to the dashboard. When output is piped, bare Rift prints a status summary instead of opening the TUI.

# Projects and views

Press ← to open the project picker. Repositories and linked worktrees are grouped together. Move to a project and press Enter to open it; the selected project controls which data and settings you see.

  • Home: the project overview, current activity, and Recall summary.
  • Models: observed model usage. This is read-only and does not select your agent's model.
  • Activity: recorded sessions and coding activity.
  • Token usage: captured usage and related views.
  • Recall viewer: checkpoints, session timelines, and recalls.
  • Settings: project capture, Recall, privacy options, and integrations.

# Keyboard shortcuts

The hint bar describes the keys available in the current view. Menus, the viewer, settings, and confirmation screens handle their own keys.

KeyAction
Tab / Shift-TabPrevious or next dashboard view. In the project picker, switch filters.
[ / ]Previous or next dashboard view.
←Open the project picker. In the viewer, an expanded file may fold first.
↑ / ↓ or j / kMove through projects, lists, or the current view.
Enter / →Open the selected project from the picker.
sOpen Project Settings from the dashboard.
rOpen the Recall viewer from the dashboard.
/Open the command palette.
?Show help.
EscDismiss the current picker, menu, or overlay.
q / Ctrl-CQuit. Close an open overlay first when it owns the keyboard.

# Inspect a session

Open the Recall viewer with r from the dashboard, or run rift viewer from your terminal. Select a checkpoint, then move through its timeline to inspect prompts, file edits, and recalls. Arrow keys expand and fold file entries.

The viewer is read-only. A project with little captured activity may have few entries; check rift status if you expected more. In the Recall summary, keys 1–4 select the 24-hour, 7-day, 30-day, or all-time period when advertised by the hint bar.

# Slash commands

Press /, type a complete command, then press Enter to run it. Press Esc to cancel. Commands use the selected project, which may differ from the folder where you launched Rift.

  • /help — List the palette commands.
  • /select #2 — Select the second registered project; a project name also works.
  • /settings — Open settings for the selected project.
  • /viewer — Open its read-only checkpoint and session viewer.
  • /status — Show the selected project’s status.
  • /doctor — Check its setup and show suggested fixes.
  • /checkpoint list — List recorded checkpoints.
  • /session list — List recorded sessions.
  • /worktrees — Inspect linked worktrees.
  • /verify — Check the integrity of recorded history.
  • /init — Set up the selected project, after confirmation.
  • /quit — Close Rift.

Actions that change setup or integrations ask for confirmation. The palette accepts Rift commands; run shell commands in your normal terminal. See the CLI reference for commands outside the dashboard.