# Add to your Claude Code skills
git clone https://github.com/lanes-sh/appNo comments yet. Be the first to share your thoughts!
You have five AI coding agents running across eight terminal tabs. One is waiting for input. One finished ten minutes ago and you didn't notice. Two are doing overlapping work. The only thing keeping it all together is your short-term memory, and it just failed.
AI agents got powerful. The workflow around them didn't.
Lanes is a native desktop app that puts every AI coding session on an issue board. Each card is a task. Each task can have a live agent terminal attached. You see what's running, what's blocked, what's waiting, and what shipped, in one window, at a glance.
No context switching. No lost terminals. No wondering what that tab was doing. Just drag work through your pipeline while your agents execute.
It's the layer that was missing between you and your fleet of AI agents.
brew install --cask lanes-sh/lanes/lanes && open -a Lanes
Requires macOS Ventura or later. Native on Apple Silicon and Intel.
Join our Discord community for updates, to share feedback, ask questions, and connect with other users. We're iterating fast and Discord is the best way to stay in the loop.
Drag issues through workflow columns, Planning, Implementation, Review, Done, plus Backlog and Misc. Multi-select with Shift+Click and Cmd+Click for bulk operations. Right-click context menus, sorting options, and collapsible columns. Board tabs scoped per project directory and worktree.
Every issue runs an AI session in a real PTY-backed terminal. Start sessions in plan mode or implement mode. Resume Claude sessions across restarts. Drag files onto the terminal to inject paths. Real-time status detection: busy, awaiting input, stopped, exited, error.
Auto-create git worktrees per issue with generated branch names, or select existing worktrees. Status overview in the status bar showing uncommitted and unmerged state. Auto-cleanup on issue completion. Per-project base branch detection with manual override.
Create, rename, and assign labels with 13 color options. Filter the board by label, working directory, or workflow step. Clear all filters in one action.
Link issues as dependencies via a multi-select picker. Cycle detection prevents circular chains. Dependent issues stay blocked until all prerequisites reach Done.
Preset and custom commands with keyboard shortcuts Cmd+Alt+1–9. Two types: claude (injected into CLI session) and terminal (run as shell command). Built-in defaults shipped with new installs, fully customizable in Settings.
Sidebar file tree for the selected issue's working directory. Monaco editor with tabbed editing, dirty file tracking, syntax highlighting, and save on Cmd+S.
Diff view with two modes: Changes (uncommitted working tree diff) and History (committed diffs). Monaco-powered inline diff viewer. Automatic branch detection from the issue's worktree.
Discover running CLI processes across the system. Three-way classification: Tracked (managed by Lanes), Orphan (has issue ID but no active session), External (unrelated). Kill individual processes or stop all sessions at once.
Claude Code, Anthropic's CLI for Claude.
Support for Codex CLI, Gemini CLI, and other terminal-based AI tools is on the roadmap.
Lanes ships a built-in Model Context Protocol server so agents like Claude Code and Codex can read your board and drive sessions directly. Enable it in Settings > Local MCP, then click Connect Claude Code or Connect Codex for one-click config injection.
| | |
|---|---|
| Server name | lanes |
| Transport | SSE (Server-Sent Events) |
| Endpoint | http://localhost:5353/sse |
| Protocol version | 2024-11-05 |
| Server version | 1.0.0 |
| Tool count | 15 |
| Auth | None — localhost-only, never leaves your machine |
| Tool | Description |
|---|---|
| lanes_list_issues | List issues from the Lanes board with optional filters (step, tags, componentId, search). |
| lanes_get_issue | Get a single issue by its numeric ID, including full details and session history. |
| lanes_create_issue | Create a new Lanes issue. Returns the created issue with its assigned ID. |
| lanes_update_issue | Patch an existing issue. Only the fields you supply are updated. |
| lanes_delete_issue | Permanently delete an issue and all its attachments. |
| lanes_move_issue | Move an issue to a different board column. |
| Tool | Description |
|---|---|
| lanes_start_session | Start a Claude Code, Codex, or shell session for an issue. Handles worktree creation, plan mode, custom prompts, and extra CLI flags or env vars. |
| lanes_stop_session | Stop the running terminal session for an issue. |
| lanes_get_session_status | Get status (running/stopped, CLI tool, timestamps, PTY state) for all sessions, or filter to one issue. |
| Tool | Description |
|---|---|
| lanes_get_issue_changes | Get the list of files changed (git diff) in the issue's working directory. |
| lanes_get_issue_history | Get Claude session conversation history for an issue, paginated. |
| lanes_read_terminal | Read the last N lines of terminal scrollback for a session. Works with any CLI; ANSI codes stripped. |
| lanes_get_session_stats | Get token usage and tool usage stats for an issue's Claude session. |
| Tool | Description |
|---|---|
| lanes_list_labels | List all board labels (UUID, name, color). Call before tagging to resolve names to UUIDs. |
| lanes_list_components | List all project components (UUID, name, project ID). Call before setting componentId. |
Full parameter schemas and example prompts: lanes.sh/docs/local-mcp.
This repo is also a Claude Code plugin marketplace. Two skills + a setup command teach Claude Code how to use the Lanes MCP intelligently:
lanes-sessions — driving the lanes_* tools through chat: creating issues, starting/inspecting sessions, batch-launching, worktrees, terminal output, label/component lookups. See plugins/lanes/skills/lanes-sessions/SKILL.md.linear-lanes-bridge — importing Linear issues into Lanes for local Claude Code execution, decomposing tickets, and pushing PR links / comments back to Linear. Requires Linear MCP. See plugins/lanes/skills/linear-lanes-bridge/SKILL.md./lanes:setup-mcp — slash command that connects Claude Code to the running Lanes app and verifies the SSE endpoint is live, so first-time setup works from chat instead of the Settings panel.In any Claude Code session:
/plugin marketplace add lanes-sh/app
/plugin install lanes@lanes
/lanes:setup-mcp
This pulls the marketplace from this repo, installs the lanes plugin (skills + commands), then runs the setup command to register the MCP. Updates: /plugin marketplace update lanes. Versioned via .claude-plugin/plugin.json.
npx skills add lanes-sh/app
skills.sh installs only the SKILL.md files. To also enable the MCP, run:
claude mcp add --transport sse lanes http://localhost:5353/sse --scope user
then restart Claude Code. Lanes itself must be running (the desktop app open) for the MCP endpoint to respond.
Lanes checks for updates on launch and updates itself. You can also check manually in Settings > About > Check Now.
| Shortcut | Action | |---|---| | Cmd+N | New backlog issue | | Cmd+T | New Misc task | | Cmd+D | Complete selected issue(s) | | Cmd+, | Open Settings | | Cmd+S | Save file in editor | | Cmd+A | Select all in column, then all issues | | Cmd+Alt+1-9 | Run quick command by position | | Shift+Click | Range select issues | | Cmd/Ctrl+Click | Toggle individual issue selection | | Escape | Clear selection or close dialog |
User Guide, everything you need to know to get the most out of Lanes
Tauri 2. React 19. SQLite. Local-first architecture. Your code and data never leave your machine. Fast startup, low memory footprint, native performance.
Proprietary. All rights reserved.