yume

<div align="center"> <img src="assets/yume.png" alt="yume logo" width="120"> <h3>claude code, unchained</h3> <p>orchestration flow. agent teams. background agents. interleaved thinking.<br>4 built-in agents. vim mode. plugins & skills. 4 providers. mac, windows, linux.</p> <p> <a href="https://aofp.github.io/yume">Download</a> </p> </div>

---

why yume?

Claude Code is transformative for development. Terminal interfaces hold it back.

terminal limitations

• flickering — 700+ upvoted github issue, fundamentally unfixed
• performance degradation — multi-second delays in extended sessions
• terminal crashes — IDE instability after 10-20 minutes of heavy use
• hidden rate limits — requires manual /usage checks
• fragile sessions — complete loss on crash, no recovery mechanism

yume's approach

• ✅ native rendering - hardware-accelerated UI, zero terminal artifacts
• ✅ consistent <50ms latency - responsive input across unlimited session length
• ✅ standalone architecture - immune to IDE/terminal crashes
• ✅ persistent rate limit display - 5-hour and 7-day metrics always visible
• ✅ automatic session recovery - 5-minute checkpoint intervals with 24-hour retention

---

how it works

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 claude binary 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.

---

features

orchestration flow (unique to yume)

• 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

agent system

• 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})
• no timeout - agents run until completion, output to ~/.yume/agent-output/
• 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 teams - multi-agent coordination with task tracking (Cmd+Shift+T)

multi-provider support

• 7+ models, 4 providers - via yume-cli shim
  • claude sonnet 4.5/4.6, opus 4.5
  • gemini 2.5 pro, flash
  • gpt-5.2 codex, codex mini
  • kiro (latest)
• protocol normalization - stream-json output for all providers
• same interface - switch providers without changing workflow

core features

• 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 - 32+ shortcuts, full mouse-free navigation
• <50ms response time - instant UI regardless of session length
• standalone reliability - independent process, immune to IDE crashes
• auto-compaction - variable threshold (default 75%), user configurable or disable
• effort controls - low/medium/high effort level, compact toggle in context bar
• schedule system - /schedule 5m, /schedule 2pm, /schedule done for 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

plugin & skills system

• complete extensibility - commands, agents, hooks, skills, MCP servers
• skills auto-injection - context based on file extensions, keywords, regex
• plugin directory - install/enable/disable per component
• bundled yume plugin - default commands and agents

additional features

• crash recovery - 30s auto-save, 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
• 15+ slash commands - /config, /theme, /stats, /memory, /mcp, /tasks, and more

customization

• 12 themes, infinite combinations - accents, backgrounds, foregrounds fully customizable
• OLED optimization - pure black (#000000) default
• 100% CLI compatibility - subagents, MCP, hooks, skills, claude.md, /commands

---

tech stack

• tauri 2.9 - 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

---

comparison

| feature | cli | cursor | opcode | crystal | yume | |---------|-----|--------|--------|---------|------| | orchestration flow | ✗ | ✗ | ✗ | ✗ | ✓ auto | | background agents | ✗ | ✗ | ✗ | ✗ | ✓ 4 async | | interleaved thinking | ✗ after | ✗ | ✗ | ✗ | ✓ live toggle | | multi-provider | ✗ | ✗ | ✗ | ✗ | ✓ 7+ models / 4 providers | | limits always visible | /usage | ✗ | ✗ | ✗ | ✓ always | | plugin/skills system | ✗ | ✗ | ✗ | ✗ | ✓ unique | | 4 built-in agents | ✗ | ✗ | ✗ | ✗ | ✓ | | crash recovery | ✗ | ✗ | ✗ | ✗ | ✓ 24hr | | @ mentions | partial | ✗ | ✗ | ✗ | ✓ | | stream timers | ✗ | ✗ | ✗ | ✗ | ✓ live | | native app | terminal | electron | tauri | electron | ✓ tauri | | customization | ✗ | ~5 themes | ✗ | ✗ | ✓ ∞ | | price | pro/max | $20-200/mo | ✓ free | ✓ free | ✓ free |

---

download

visit aofp.github.io/yume for all download options.

---

keyboard shortcuts

| 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 | | agent teams | ⌘⇧T | Ctrl+Shift+T | | 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.

---

agents

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}
• no timeout (runs until completion)
• output to ~/.yume/agent-output/
• streaming isolation from main session
• merge conflict detection
• worktree isolation: full filesystem isolation
• permission modes + memory scope

---

requirements

• claude subscription - pro or max required for claude code access
• macos 11+ (big sur or later) — arm64 + x64
• windows 10+ (64-bit) — exe installer
• linux ubuntu 20.04+ or equivalent — deb + rpm + flatpak

---

license

yume is free to download and use (trial: 3 tabs, 1 window). upgrade to pro for 99 tabs and 99 windows ($29 one-time payment).

---

links

• 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

---

<div align="center"> <p>made with claude code + yume</p> </div>