orchestration flow. live interleaved thinking. background agents. plugins & skills.
4 built-in agents. vim mode. 4 providers. 7 languages. mac, windows, linux.
Claude Code is transformative for development. Terminal interfaces hold it back.
- flickering — terminal redraw artifacts, a long-standing cli complaint
- input lag — terminal rendering slows down in extended sessions
- single session per window — parallel work means juggling terminals
- rate limits on demand only — requires manual
/usagechecks - no gui affordances — no visual diffs, clickable rollback, or drag-and-drop
- ✅ native rendering - hardware-accelerated UI, zero terminal artifacts
- ✅ responsive input - typically <50ms, independent of session length
- ✅ standalone app - your session doesn't die with your terminal or IDE
- ✅ persistent rate limit display - 5-hour and 7-day metrics always visible
- ✅ automatic session recovery - 5-minute snapshots with 24-hour retention
yume is not an alternate harness or api wrapper. we spawn the official claude code cli as a subprocess.
yume app → spawns real cli binary → cli handles auth → anthropic servers
this is fundamentally different from tools that spoof headers to bypass api pricing. yume:
- runs the actual
claudebinary installed on your machine - uses your existing claude pro/max subscription
- never touches anthropic's api directly
- maintains 100% cli compatibility (subagents, mcp, hooks, skills, claude.md all work)
think of it like iterm vs terminal.app - a different frontend for the same tool.
- automatic task decomposition - understand → decompose → act → verify workflow
- complex task handling - 3+ step tasks get architect planning, implementer execution, guardian verification
- trivial task passthrough - simple tasks proceed directly without overhead
- no commands needed - baked into every session via --append-system-prompt
- 4 built-in agents - synced to ~/.claude/agents/yume-*.md
- architect - plans, decomposes tasks, identifies risks, todowrite tracking
- explorer - read-only codebase search, glob/grep/read, never modifies
- implementer - focused code changes, edit/write, minimal diffs
- guardian - reviews for bugs, security, performance after changes
- 4 concurrent background agents - async execution with git branch isolation (yume-async-{type}-{id})
- 30-minute timeout per agent - output to ~/.yume/agent-output/, 24h retention
- streaming isolation - background agents don't interfere with main session
- merge conflict detection - pre-merge checks before integrating agent work
- worktree isolation - full filesystem isolation via git worktree
- agent coordination - inter-agent messaging to hand off work between background agents
- 15+ models, 4 providers - non-claude providers via yume-cli shim
- claude fable 5 (default flagship), sonnet 5 (1M context), sonnet 4.6, opus 4.8, haiku 4.5
- gemini 3.1 pro preview, gemini 3 flash preview
- gpt-5.5, gpt-5.4 mini
- kiro (auto, claude sonnet 4.5, claude haiku 4.5, glm-5)
- protocol normalization - stream-json output for all providers
- same interface - switch providers without changing workflow
- persistent rate limit visibility - 5h and 7d limits always visible, no /usage needed
- zero visual artifacts - native rendering eliminates terminal flickering
- interleaved thinking toggle - watch claude reason live, word-by-word, with on/off control
- keyboard-first - 50+ shortcuts, full mouse-free navigation
- <50ms response time - instant UI regardless of session length
- standalone reliability - independent process, immune to IDE crashes
- auto-compaction - dynamic threshold (default 85%), user configurable or disable
- effort + budget controls - low/medium/high/xhigh effort and thinking budget per model
- usage-limit guard - optionally stops new claude turns before the 5-hour window hits 100%, so a subscription never spills into metered overage
- schedule system -
/schedule 5m,/schedule 2pm,/schedule donefor timed and event-based tasks - askuser ipc - claude asks structured questions mid-session with choice popover
- secret censoring - api keys and tokens automatically redacted in all output
- 7 languages - english, spanish, french, german, polish, chinese, japanese
- complete extensibility - commands, agents, hooks, skills, MCP servers, monitors
- 23 hook events - pre-tool-use, post-tool-use, context warnings, compaction, subagent lifecycle, and more
- skills auto-injection - context based on file extensions, keywords, regex
- plugin directory - install/enable/disable per component
- bundled yume plugin - default commands and agents
- crash recovery - 5-min snapshots, 24hr retention, complete session restore
- history rollback - restore points per message, conflict detection, undo edits
- mid-stream context - real-time token updates during streaming
- analytics dashboard - usage by project/model/date, cost tracking, export
- voice dictation - F5 to toggle, native speech-to-text
- @ mention system - @ shows recent/modified files with autocomplete, folder navigation
- vim mode - full normal/insert/visual/command modes for chat navigation
- row split panels - up to 6 panels in 3x2 grid with F7/F8 split/combine
- rules management - .claude/rules/ CRUD in settings
- image thumbnails - drag-and-drop images with compression pipeline
- slash commands - /schedule, /loop, /compact, /clear, /model, /resume, /usage, plus custom and cli commands
- 18 themes - 12 dark (OLED-optimized) + 6 light; accents fully customizable
- OLED optimization - pure black (#000000) default
- 100% CLI compatibility - subagents, MCP, hooks, skills, claude.md, /commands
- tauri 2.10 - rust backend, native speed
- react 19 - modern ui with virtualized rendering
- sqlite + wal - sessions, messages, analytics persistence
- socket.io - real-time streaming with mid-stream context updates
- compiled binaries - no node.js dependency for end users (@yao-pkg/pkg)
- 3-process architecture - tauri (rust) + react ui + node.js server
- zero telemetry - your code stays on your machine
same cli, same claude subscription — different frontend. what yume adds on top of a plain terminal:
| feature | cli in a terminal | cli in yume |
|---|---|---|
| interface | text ui, one session per window | native app — tabs, panes, windows |
| orchestration flow | manual prompting | ✓ baked into every session |
| background agents | run more terminals | ✓ 4 parallel, branch/worktree isolated |
| thinking display | plain text scrollback | ✓ live stream with toggle + timers |
| usage limits | /usage on demand |
✓ 5h + 7d always visible, overage guard |
| context | /context on demand |
✓ live token bar, one-key compact |
| file changes | text diffs | ✓ visual diffs + per-message rollback |
| crash recovery | --resume after restart |
✓ 5-min snapshots, full layout restore |
| providers | claude | ✓ claude + gemini + openai + kiro |
| customization | terminal theme | ✓ 18 themes, custom colors, fonts, vim mode |
| price | free with your claude plan | free demo · $4/mo · $49 lifetime |
yume licenses the app — claude usage stays on your existing claude plan or api key, with no markup. ide-style tools (cursor, windsurf, …) solve a different problem: they bundle model access into $20+/mo subscriptions.
visit aofp.github.io/yume for all download options.
| action | macOS | Windows/Linux |
|---|---|---|
| new tab | ⌘T | Ctrl+T |
| close tab | ⌘W | Ctrl+W |
| duplicate tab | ⌘D | Ctrl+D |
| fork session | ⌘⇧D | Ctrl+Shift+D |
| command palette | ⌘P | Ctrl+P |
| files panel | ⌘E | Ctrl+E |
| git panel | ⌘G | Ctrl+G |
| model & tools | ⌘K | Ctrl+K |
| toggle model | ⌘⇧K | Ctrl+Shift+K |
| open project | ⌘O | Ctrl+O |
| settings | ⌘, | Ctrl+, |
| search messages | ⌘F | Ctrl+F |
| new pane | ⌘N | Ctrl+N |
| new window | ⌘⇧N | Ctrl+Shift+N |
| agents | ⌘⇧A | Ctrl+Shift+A |
| clear context | ⌘L | Ctrl+L |
| compact context | ⌘M | Ctrl+M |
| recent projects | ⌘R | Ctrl+R |
| analytics | ⌘Y | Ctrl+Y |
| split all panes | F8 | F8 |
| combine panes | F7 | F7 |
| vim mode | toggle in settings | toggle in settings |
50+ shortcuts total. every action accessible via keyboard on all platforms.
yume includes 4 built-in agents synced to ~/.claude/agents/yume-*.md + 4 concurrent background agents:
foreground agents (follows selected model):
- architect - plans, decomposes, todowrite. runs before complex tasks.
- explorer - read-only glob/grep/read. understands codebase.
- implementer - edit/write. focused changes, minimal diffs.
- guardian - reviews for bugs, security, performance.
background agents (4 concurrent, async):
- git branch isolation: yume-async-{type}-{id}
- 30-minute timeout per agent
- output to ~/.yume/agent-output/
- streaming isolation from main session
- merge conflict detection
- worktree isolation: full filesystem isolation
- permission modes + memory scope
- claude account - pro/max subscription or api key for claude code access (yume adds no markup)
- macos 11+ (big sur or later) — arm64 + x64
- windows 10+ (64-bit) — exe installer
- linux ubuntu 20.04+ or equivalent — deb + rpm + flatpak
yume is free to download and use (demo: 2 tabs, 2 panes, 1 window). upgrade to pro for 99 tabs, 99 panes, 99 windows.
- monthly — $4/mo, paypal subscription, cancel anytime, access until period ends
- lifetime — $49 one-time payment, forever updates
license is re-verified weekly with a 7-day network grace period. on validation failure, yume reverts to demo and offers a retry banner (key is retained).
- download: aofp.github.io/yume
- docs: aofp.github.io/yume/docs/
- issues: github.com/aofp/yume/issues
- discord: discord.gg/RhWVqCUnCc
- claude code cli: github.com/anthropics/claude-code
made with claude code + yume