Moe's Tavern

An AI agent task board for Claude Code, Codex, Gemini CLI and Grok Build

View on GitHub Get Started

Features

Kanban Board

Visual task management directly in your IDE. See what AI agents are working on at a glance.

Plan Approval

Review and approve AI implementation plans before any code gets written.

Multi-Agent

Run architect, worker, QA, and governor agents with distinct roles and tools.

MCP Protocol

Agents connect through the bundled MCP proxy. Claude Code, Codex, Gemini CLI, and Grok Build are supported out of the box.

Real-time Sync

Live updates via WebSocket keep all clients synchronized instantly.

Rails System

Define constraints that AI must follow at project, epic, or task level.

Architecture

    +------------------+     +------------------+     +------------------+
    |  JetBrains IDE   |     |    AI Agents     |     |   Other CLIs     |
    |    (Plugin)      |     | (Claude Code...) |     |                  |
    +--------+---------+     +--------+---------+     +--------+---------+
             |                        |                        |
             | WebSocket              | MCP (stdio)            |
             |                        |                        |
             v                        v                        v
    +--------+------------------------+------------------------+---------+
    |                         Moe Daemon                                 |
    |                    (WebSocket + MCP Server)                        |
    +-----------------------------------+--------------------------------+
                                        |
                                        | Read/Write
                                        v
                              +---------+---------+
                              |    .moe/ folder   |
                              |  (source of truth)|
                              +-------------------+

Key Principle: The daemon is the sole writer of .moe/ files. All clients communicate through the daemon.

Getting Started

Install from a marketplace (v0.8.0 and later): in a JetBrains IDE open Settings → Plugins → Marketplace and search for "Moe's Tavern"; in VS Code or Antigravity install yaront1111.moe-vscode (VS Code Marketplace or Open VSX); for terminal-only use, npm install -g moe-daemon moe-proxy. The ZIP and .vsix are also attached to each GitHub Release. The IDE plugins bundle the daemon and proxy; you still need Node.js and a coding CLI (Claude Code, Codex, Gemini CLI, or Grok Build).

Build from source: download the source ZIP, extract it, and open a terminal in the extracted Moe folder. The installer handles missing dependencies, installs your coding CLI, and builds Moe and the board plugin.

Use a JetBrains IDE for the board. Automatic dependency installation supports Windows with WinGet, macOS with Homebrew and Command Line Tools, and Linux with apt-get or dnf. It may request operating system permission to install system packages.

Windows

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-all.ps1 -BuildPlugin

Mac / Linux

bash scripts/install-mac.sh --global --skip-mcp --with-plugin

Open the board and complete a task

  1. Install the plugin from the Marketplace, or the ZIP you built from moe-jetbrains/build/distributions/ through your IDE's Plugins → Install Plugin from Disk menu, and restart. Run your CLI once to sign in. Open your target project and its Moe tool window; wait for Connected.
  2. Keep Approval Mode: CONTROL in Project Settings. Click + Epic, then use the + in its Backlog column to create one small task with a description and Definition of Done.
  3. Drag the task to Planning. Choose Agents → Architect → your CLI.
  4. When the task shows Awaiting Approval, open it, read the plan, and click Approve.
  5. Launch Worker and QA from the Agents menu. Keep their terminals open.
  6. Follow Working → Review → Done, then inspect the verification result, QA summary, changed files, and recorded Git commit.

Moe's launchers commit task changes and attempt to push them by default. Review any reported Git or verification failure before treating a task as delivered.

Follow the full first-task guide for exact commands, CLI selection, PATH fixes, and troubleshooting. Marketplace builds and GitHub Release assets are built from the release tag; if you build from source, install the plugin you built.