Omnivue is a 100% local multi-agent session manager for your AI coding sessions. It reads the session data already on your machine and presents it all in one place — conversation history, file diffs, implementation plans, and more.
Features
- Multi-agent support — OpenCode, Copilot, Cursor, Pi, Claude Code, and Codex out of the box
- Sub-agent awareness — Sub-agent transcripts are grouped under their root session and switchable from the session header's family selector
- Cinematic session view — Full-screen playable workspace: a timeline scrubber with playback, turn isolation, an activity/plan/prompt drawer, a console, and a file-access tree
- File viewer — Browse the files a session read or edited; render markdown from disk and view merged diffs in place
- Embedded terminal — In-browser PTY that runs the agent's resume command (xterm.js + WebSocket)
- Conversation viewer — Full message history with tool calls, reasoning, and step events
- File diffs — Unified diff view of every file change made during a session
- Plan tracking — Implementation plans and checkpoints with status indicators
- Prompt pad — Global, session-independent library of reusable prompts: paste straight from the clipboard, copy back, pin, reorder, and check off
- Live updates — Adaptive SSE-based polling (5s when active, 30s when idle) with notification events
- Full-text search — FTS5 index across all session content and tags, scoped or global
- Notifications — In-app toasts and OS notifications for new messages, questions, task completions, and status changes; configurable kinds, scope, and channels
- Bookmarks — Toggle bookmarks on any message, tool call, or plan item; navigate from a sidebar panel
- User tags — Virtual organization with unique names, custom colors, and searchable grouping
- Scratch notes — Per-session markdown notes with rich text or code editor
- Session renaming — Override display names from the sidebar
- Screenshot capture — Export markdown screenshots of the conversation
- Overview screen — Analytics dashboard with session activity charts, model/agent breakdown, and time-range filtering
- Settings UI — Agent, sessions, notifications, appearance, privacy, developer, and about tabs
- Resume sessions — One-click copy of the CLI command to resume, or open an embedded terminal
- Collapsible sidebar — Icon-channel navigation (sessions, prompts, tags, bookmarks, notifications) with a collapsible, resizable side panel
- Keyboard-driven —
j/k navigate, ⌘1/⌘2 session & plan, ⌘K search, ? shortcuts reference
- Deep linking — Shareable URLs for sessions and sections (
#/session/{id}, #/tags, #/search?q=…); Back/Forward undo navigation
- Multi-theme — Ayu, Nord, Catppuccin, Tokyo Night, GitHub, One Monokai, Atom One, Dracula, and Night Owl themes with light/dark modes and high-contrast support
- Read-only access — Never writes to agent databases (enforced at driver level)
- Single binary — Go + embedded React SPA, zero runtime dependencies
Local by Design
Omnivue keeps your workflow on your machine:
- 100% local — Reads local session stores and writes only to its own local state database
- No cloud sync — Nothing is uploaded, indexed remotely, or sent to a hosted service
- Read-only adapters — Agent databases are opened in read-only mode and never modified
- localhost UI — The browser app runs against a local server on your machine
Getting Started
1. Homebrew (macOS)
brew install stevencrawford/tap/omnivue
2. Build from source
Requires Go 1.26.8+, Node.js, and pnpm.
git clone https://github.com/stevencrawford/omnivue.git
cd omnivue
make build
./omnivue --foreground --port 16275
CLI
| Command | Purpose |
|---|
omnivue | Start the server in the background and open the browser |
omnivue init | Discover agent data locations and interactively add sources |
omnivue add <path> [--type <agent>] | Add a source manually; the type is auto-detected unless forced |
omnivue --foreground | Run the server in the foreground |
omnivue --status [--json] | Show running servers |
omnivue --shutdown | Stop the running server |
omnivue --restart | Restart the running server |
omnivue version [--json] | Print version and revision |
omnivue upgrade [--check] | Upgrade from GitHub releases, or check for a newer version |
Common flags: --port / -p (default 6275), --bind / -b (default
localhost), --open, --no-open, --debug / -d.
Omnivue's own state (sources, tags, prompts, search index, scratch notes,
bookmarks, notification settings) lives in
$XDG_STATE_HOME/omnivue/omnivue.db. Agent databases are only ever read.
Keyboard shortcuts
| Key | Action |
|---|
j / ↓ | Select next session |
k / ↑ | Select previous session |
⌘1 / Ctrl+1 | Session tab |
⌘2 / Ctrl+2 | Plan tab |
⌘K / Ctrl+K | Open search palette (scoped to active session) |
↑ / ↓ | Navigate search results |
↵ | Open search result |
⌘↵ / Ctrl+↵ | Open results drawer |
⌘B / Ctrl+B | Toggle sidebar |
? | Open shortcuts reference |
Escape | Close search / drawer / modal, clear highlight |
Documentation
| Document | Contents |
|---|
| docs/API.md | HTTP endpoints, request/response shapes, SSE events, terminal protocol |
| docs/ADAPTERS.md | Supported agents, data formats, capabilities, resume commands, adding an adapter |
| docs/FRONTEND.md | Frontend stack, component catalog, hooks, state, localStorage keys, tool renderers |
| docs/NOTIFICATIONS.md | Notification kinds, settings, scope, deduplication, delivery channels |
License
MIT License — see LICENSE.
