Dashboard & TUI
Canopy is Rift’s terminal dashboard. Use it to move between projects, follow agent work, and review captured sessions.
Browse guides Dashboard & TUI
# Open the dashboard
rift
rift --ascii
rift --skip-splashRun 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.
| Key | Action |
|---|---|
| Tab / Shift-Tab | Previous 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 / k | Move through projects, lists, or the current view. |
| Enter / → | Open the selected project from the picker. |
| s | Open Project Settings from the dashboard. |
| r | Open the Recall viewer from the dashboard. |
| / | Open the command palette. |
| ? | Show help. |
| Esc | Dismiss the current picker, menu, or overlay. |
| q / Ctrl-C | Quit. 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.