buddy
ryan-mt/buddy
Mission control for your AI agent fleet - Claude Code, Codex, Gemini, opencode & Grok side by side in liquid glass. Tauri 2 + React 19.
Instalação
npx convez-ai ryan-mt/buddy1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
buddy
A desktop app to run and manage many AI agent CLI sessions side by side — Claude Code, Codex, Gemini, opencode, and Grok — in embedded interactive terminals, with projects, isolated account profiles, split layouts, a code editor, and session history.
Built with Tauri 2 (Rust backend) + React 19 / TypeScript / Vite, with
real PTY terminals via portable-pty (ConPTY on Windows) rendered with
xterm.js.
Features
- Multi-CLI sessions. Auto-detects installed CLIs and launches each in a real interactive terminal. An adaptive New Session dialog exposes the model / permission / effort controls each CLI actually supports.
- In-app installer. Install any supported CLI with the vendor's official per-OS command, streamed in a terminal; detects missing Node and guides you.
- Projects. Add folders to launch sessions in (cwd) or open in the editor.
- Profiles (multiple accounts). Each profile owns an isolated config directory, so you can log in to separate Claude / Codex accounts and run them at the same time, with optional default model / base-URL overrides.
- Splits & zoom. Tile sessions into flexible split panes; drag dividers to
resize, or zoom one pane full-size (
Ctrl/Cmd+Shift+Z). Terminals stay mounted (PTY-safe) and are just repositioned. - Find in terminal. Search the scrollback of any session
(
Ctrl/Cmd+Shift+F, Enter / Shift+Enter to step through matches). - Session care. Rename sessions in place (double-click the title), and a confirmation guards closing a session that's still running. Failed actions surface as toasts instead of failing silently.
- Crash-proof workspace. The open sessions + split layout are snapshotted on every change; after a restart or crash buddy offers to restore the whole workspace (Claude sessions resume their conversation). A pane whose process exits keeps its scrollback and grows a one-click Resume / Relaunch bar, and a render crash lands in a recoverable panel instead of a white screen.
- Live agent status. Each session's dot tells you what the agent is doing — a static lit halo while it streams output, a warning ring when it rang the bell for input (permission prompts). When buddy is in the background, the Windows taskbar flashes for needs-input and for long runs finishing.
- Formations. Save the current split — which CLIs, in which panes, with which cwd / model / profile — as a named preset, and relaunch the whole squad in one click.
- Prompt composer & queue. Write a prompt once (
Ctrl/Cmd+Shift+P) and send it to the active pane or every visible pane; busy agents queue prompts and receive them when their output settles. Favourite prompts persist as snippets.Ctrl/Cmd+Shift+Bbroadcasts raw keystrokes to all panes. - Small comforts. Sessions auto-title themselves from your first prompt, the header shows session uptime, and any pane's scrollback exports to a text file.
- Code editor. Monaco-based editor with a lazy file tree, tabs, dirty tracking, and save (bundled fully offline).
- History & resume. Every session is recorded; resume past Claude sessions
(
--resume) either from buddy's history or from what's on disk in~/.claude. Read past transcripts in a viewer with token totals. - Settings & shortcuts. Light / dark theme, terminal font size, default
Claude permission / effort. Global shortcuts:
Ctrl/Cmd+Shift+Tnew session,+Wclose,+Ffind,+Zzoom pane,+Bbroadcast,+Pcomposer,+1…9switch,+,settings. - Liquid-glass UI. Warm, organic palette with frosted-glass chrome (sidebar, header, dialogs) over an ambient color mesh. Status is shown with static glows and rings — nothing blinks.
Develop
npm install
npm run tauri dev
Build
npm run tauri build # release binary + OS installer
Checks
npm run build # tsc + vite build
cargo test --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
Notes
- Profiles use up-to-date isolation env vars — Claude
CLAUDE_CONFIG_DIR, CodexCODEX_HOME. The other CLIs expose no documented config-dir env var, so a profile applies no overrides for them rather than guessing one. - Resume + profiles caveat. Claude's
--resumecurrently reads only~/.claude/projects/and ignoresCLAUDE_CONFIG_DIR(claude-code#16103), so resuming a profile-bound Claude session may not find its transcript. Default (no-profile) sessions resume normally, and the transcript viewer works for every session regardless of profile. - Models use official aliases (opus/sonnet/haiku, pro/flash/…) that resolve to the latest real model, plus a free-text Custom… field — no version numbers are hard-coded.