AgentGrove

AgentGrove is a local developer workspace that keeps your projects, git worktrees, terminal, database, notes, team chat, and AI agents in one window. The backend is Rust; the UI is SolidJS. It runs on Linux, macOS, and Windows.

Demo

One screen recording of the main flows. Everything was captured inside the isolated Docker demo stack so the dev server on the host is untouched. Click the thumbnail to watch:

The walkthrough covers, in order: workspace overview, AI chat with the rich composer and prompt queue, worktree sessions, PR badges, integrated terminal, database editor, file search, git diff, notes, team chat, settings, revert-with-AI, and layout toggles.

Quick Start

# Install prerequisites (macOS with Homebrew)
brew install node pnpm just
# Rust toolchain — project pins 1.95 via rust-toolchain.toml
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone and run
git clone https://github.com/arnabk/agentgrove.git
cd agentgrove
just dev    # starts BE (hot reload) + FE (HMR) on http://localhost:5173

On Linux, install the same packages with your distro's package manager (e.g. apt install nodejs pnpm or pacman -S node pnpm just). Windows users can use winget install Rustlang.Rustup OpenJS.NodeJS pnpm.just or the rustup and pnpm installers.

Features

What you can do with it today.

Project Management

• Folder-based projects — add any folder; the name is derived from the path
• UI folder picker — browse the filesystem inside the app instead of using the OS dialog
• Multiple projects open — several projects at once, each with its own expand/collapse state
• Per-project settings — pre-worktree scripts inherited by every new worktree
• Project-scoped state — each project/worktree keeps its own tabs, editor state, and chat history

Git & Worktrees

• Worktree management — create, rename, and delete worktrees from the left rail
• Remote-only worktrees — gated on projects with a git remote; pre-fetches latest first
• Celestial names — worktrees get star/planet/galaxy names so you don't drown in branch names
• Pre/post scripts — run setup commands (e.g. pnpm install) with live console output
• Worktree history — soft-deleted worktrees can be searched and restored, with chat recovery
• Branch switching — switch branches from the UI with a branch picker
• Branch rename — rename a worktree's git branch without leaving the app
• Remote drift badges — ahead/behind/diverged counts on each worktree row; click behind to sync
• PR/MR badges — see open PR/MR status, checks, review decision, and merge when ready
• Worktree status badges — creating, pre_script, and failed states are visible inline
• Galaxy Map — a zoomable map of every worktree you've visited, kept across removals
• VSCode-style git diff — staged/unstaged groups with an inline CodeMirror merge view
• Diff toggles — soft-wrap and collapse-unchanged-lines, remembered per user
• Per-file discard — restore tracked files or delete untracked ones, with confirmation
• Reviewed markers — mark changed files as reviewed; progress clears automatically on new edits

Editor

• CodeMirror 6 — syntax highlighting for JS/TS, JSON, Markdown, Rust, and more
• Autosave — debounced 600ms + blur + file-switch + Cmd/Ctrl+S; no save button
• Code folding — fold/unfold with gutter markers and keyboard shortcuts
• File size guard — very large files are blocked to prevent crashes

Terminal

• WebSocket terminal — bidirectional WS for instant output and keystrokes
• Multiple terminals — as many terminal tabs as you want per project/worktree
• Correct cwd — terminals open in the right project or worktree directory
• Close confirmation — closing a terminal tab asks before killing the shell
• Auto-close on exit — Ctrl+D / exit closes the tab within ~200ms
• Session persistence — sessions survive page refresh (PTY stays alive on the backend)
• Bounded scrollback — 2000-line ring buffer keeps the footprint stable
• Resize sync — xterm dimensions sync to the backend PTY on window resize

AI Chat

• Multi-provider — Claude, opencode, and Kimi via CLI subprocess passthrough (user-authenticated)
• Live model discovery — models fetched live from providers with cache + manual refresh
• Per-chat settings — model, effort (thinking level), and slash commands configurable per chat
• Default provider/model — choose the agent and model that new chats start with
• Streaming responses — real-time token streaming over WebSocket with coalescing
• Rich-text composer — Tiptap input with markdown autoformat (lists, headings, bold, code blocks)
• Image and file paste — paste screenshots or drag/drop files; paths are appended to the prompt
• Long message truncation — long user messages and huge assistant replies collapse with show more/less
• Markdown rendering — assistant output via marked + DOMPurify; syntax-highlighted code
• Thinking blocks — extended-thinking events rendered as collapsible disclosures
• Tool activity rail — tool calls shown as icon + name + command preview rows
• Live working indicator — elapsed timer and a note when a model has no live token stream
• Chat forking — fork a conversation from any point to explore a different direction
• Message retry — re-trigger the latest user message or regenerate the last assistant turn
• Prompt revert — ask AI to undo the file changes a specific prompt produced
• Delete from point — truncate the conversation from any prompt onward
• /compact — summarize the conversation and start a fresh provider session in place
• Session resume + recovery — Claude --resume, opencode --session + --dir, Kimi --session; stale opencode sessions auto-recover and retry with recent context
• Slash commands — / menu with provider commands + user-defined prompt templates
• PR detection — auto-detects GitHub PR URLs in agent output; shows a PR badge
• Auto-approve tools — --dangerously-skip-permissions with per-chat override
• Stop button — cancel in-flight agent turns; kills the CLI subprocess cleanly
• Background finish toast — a toast appears when a chat you're not watching completes
• Inline tab rename — double-click any tab to edit its label
• Export chat — download a full chat transcript as Markdown from the tab hover menu
• Busy indicator — pulsing dot on chat tabs and worktree rows while the agent is working

Prompt Queue

• Per-chat queue — messages sent while AI is busy auto-enqueue
• Auto-drain / manual mode — dispatch back-to-back, or hold until explicit "Run next"
• Inline editing — double-click queue items to edit text; attachments preserved
• Reorder — drag queue items up/down to change execution order
• Right-side dock — always-visible, resizable queue panel inside the chat pane

Database

• Left-rail Database view — connections + tables tree next to Projects (activity-bar style)
• Connection manager — saved Postgres connections with inline Test button
• First-run seed — a local connection is created from the server default and auto-connected
• Tables browser — filterable list; paginated data grid (50/page) with column filters
• SQL editor — CodeMirror 6 with SQL highlighting and schema autocomplete; Ctrl/Cmd+Enter runs
• Safe dynamic results — SELECTs wrapped server-side so any row shape renders; DML reports affected rows

Notes / Scratchpad

• Workspace-global scratchpad — one rich-text note shared across all projects
• Tiptap-based — headings, bullets, ordered lists, task lists, bold, italic, code, quotes, links
• Drag-to-reorder — grab handle in the left gutter to move blocks
• Collapsible headings — fold sections; good for grouping todos
• Done-task toggle — show/hide completed todos with live task counts
• Autosave — debounced with blur/visibility flush; never overwrites non-empty with empty
• Cross-instance sync — edits propagate to other tabs/windows via WebSocket

Team Chat

• Real-time communication — chat with other developers on the same dev instance
• WebSocket delivery — instant message broadcast via existing /ws channels
• Unread badges — cross-browser unread indicators
• Persistent history — saved to the local SQLite database

Reusable Prompt Templates

• Settings → Prompts — CRUD for named prompt templates
• Default seeds — ships with templates (Create PR, Code review, Explain, Write tests, Refactor, Debug, Commit message, Summarize, Merge from remote)
• Quick picker — sparkle icon in chat input for instant insertion

File Search (Cmd+P)

• Fuzzy file finder — nucleo-matcher powered; sub-10ms search across 100k files
• Gitignore-aware — uses the ignore crate's parallel walker (same as ripgrep)
• Live index — per-project file index with manual refresh
• Empty-query browse — opens the first 50 indexed files before you type

Settings & Themes

• Tabbed modal — Appearance, Prompts, Providers, Agents, Backups
• Built-in themes — Dark, Light, Solarized, Tokyo Night, plus a Material Dark design system
• Custom themes — create and persist personal color themes, applied live across the app
• Fonts & size — 10+ Google Font presets for UI/mono; global 12–28px size control
• Provider management — CLI detection status; HTTP providers have config forms
• Auto-approve toggle — global default with per-chat override
• Database backups — list snapshots, restore with confirmation, auto-snapshot before migrations

Memory & Performance

• Memory indicator — top-right pill showing app-attributable, BE (Rust RSS), and JS+DOM breakdown
• Popover breakdown — click the pill for the per-category numbers
• Client memory-growth monitor — samples heap/DOM/WS every 15s; warns on sustained climb
• Bounded retention — windowed chat store (600 prompts / 400 events per prompt) + virtualized timeline
• Delta terminal streaming — WS output instead of HTTP poll loops

Cross-Instance Sync

• WebSocket broadcast — project/worktree/chat/notes mutations propagate to all clients
• Echo suppression — self-echo guard prevents reload loops on your own edits
• Layout persistence — per-scope UI state persisted to the backend via the layout API
• Route error toast — red banner when the URL points to a deleted project or worktree

Data Safety

• SQLite persistence — chats, prompts, events, queue, and layout survive backend restarts
• Auto-snapshots — DB snapshotted before every migration; rotated to the last 10
• Forward-only migrations — pre-commit hook + CI guard prevent editing applied migrations
• Restore CLI — just restore-db <name> to recover from any snapshot
• Encrypted secrets — provider API keys encrypted at rest with XChaCha20-Poly1305

Developer Experience

• Release notifications — in-app toast when a new GitHub release is available
• Hot reload — just dev runs BE (cargo-watch) + FE (Vite HMR) together
• Cross-platform — Linux/macOS/Windows; .sh + .ps1 script pairs; PathBuf only
• Draggable panels — left rail, right sidebar, and queue dock all resizable
• Left-rail collapse — hide the rail into an icon-only mini bar
• Open in OS file manager — reveal any project/worktree folder in Finder/Explorer/Files
• Custom dialogs — themed confirm/alert replace native dialogs
• URL routing — scope/pane/chat/file encoded in the URL; refresh restores deep state

Quality & Open Source

• MIT licensed with a contributing guide, Code of Conduct, and security policy
• Tested — BE endpoint e2e tests + FE Playwright specs; route inventory enforced in CI
• 3 green CI badges — CI, Release, Nightly; cross-platform nightly matrix
• Auto-release — every merge to main bumps the version and builds 4-platform binaries + a GitHub Release
• ADRs — architecture decision records documenting key choices

Documentation

All detailed docs live under docs/:

• Roadmap (working draft)
• Architecture
• Contributing
• Local dev guide
• Agent providers
• Chat & queue routing
• Data safety & restore
• Comparison with other tools
• ADRs

License

MIT