guild

Overview

Guild is a sophisticated MCP server designed for multi-agent coding environments. It maintains persistent state across AI agent sessions using local SQLite storage, enabling seamless handoffs between different AI clients. The server implements a quest-based task system with atomic claims to prevent collisions, ensuring parallel agents can work safely on the same codebase. Its hybrid search combines BM25 keyword matching with vector similarity through reciprocal-rank fusion, allowing agents to both find exact terms and semantically related information in the knowledge archive.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• guild_session_start

  Start a new session and load project context including oath, last brief, and top quest

  Try:Start a guild session for myappTry:Begin a new session for this project
• guild_quest_accept

  Accept a specific quest with atomic claim to prevent collision with other agents

  Try:Accept QUEST-42 for this sessionTry:Claim the highest priority available quest
• guild_lore_appraise

  Search the knowledge archive using hybrid keyword and semantic search before researching

  Try:Search for information about token refresh patternsTry:Look up previous approaches to database migration
• guild_lore_inscribe

  Add durable knowledge to the lore archive for future agents to discover

  Try:Record that tokens expire at 1h and should be refreshed at 55mTry:Document the decision to use exponential backoff for retries
• guild_quest_journal

  Record notes and progress for the current quest (temporary storage)

  Try:Tried using linear backoff but it failed because of race conditionsTry:Found that the API endpoint returns 429 when rate limited
• guild_quest_brief

  Write a handoff note for the next agent or session

  Try:Document that the feature was shipped in commit abc1234Try:Note that QUEST-43 is ready to start
• guild_quest_fulfill

  Complete a quest and cascade unblock dependent tasks

  Try:Mark QUEST-42 as completed with report in abc1234Try:Finish the current task and release blocked quests

Comparable tools

Installation

curl -fsSL https://github.com/mathomhaus/guild/releases/latest/download/install.sh | sh
guild --version

brew install mathomhaus/tap/guild

git clone https://github.com/mathomhaus/guild
cd guild
make install   # includes semantic retrieval assets

cd ~/projects/myapp
guild init  # interactive setup process

"mcpServers": {
  "guild": {
    "command": "guild",
    "args": ["serve"]
  }
}

FAQ

What AI clients are compatible with Guild?

Guild works with any MCP-enabled AI client including Claude Code, Codex, Cursor, and other editors that support MCP protocol. The server acts as a central coordination hub regardless of the client.

How does Guild handle multiple agents working on the same project?

Guild uses atomic claims on quests to prevent collisions. When an agent accepts a quest, it's locked to that agent until completed. The system also tracks dependencies between tasks, automatically unblocking dependent quests when prerequisites are fulfilled.

Compare guild with