Developer Tools stdio

Beads

Name: Beads
Author: steveyegge

Created by steveyegge

Provides a lightweight memory system for coding agents through a graph-based issue tracker.

How to Connect & Install

Select your client or environment below to copy the verified, ready-to-run installation configuration.

1-line autonomous agent setup instruction. Paste into Claude Code, Codex CLI, or Cursor Agent:

Fetch and configure Model Context Protocol (MCP) server Beads from https://www.fastmcp.dev/server/beads

Agents automatically discover, install, and execute the server spec without manual token setup.

Connect via direct Stateless MCP v2 / Streamable HTTP endpoint or JSON-RPC:

https://github.com/steveyegge/beads

Stateless edge endpoint compliant with MCP 2024-11-05 and v2 draft protocol specs.

Includes server instructions and tool definitions for Claude:

claude mcp add beads -- npx -y beads

Run in terminal to register server in current project or pass --scope user for global availability.

Configures server instructions and tools for OpenAI Codex & ChatGPT Desktop:

[mcp_servers.beads]
command = "npx"
args = ["-y","beads"]

Applies to ChatGPT Desktop app, Codex CLI, and IDE extension across your Codex host.

Add to Cursor project settings (.cursor/mcp.json) or Cursor Settings > Features > MCP:

{
  "mcpServers": {
    "beads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "beads"
      ]
    }
  }
}

Commit to version control to allow teammates to connect immediately.

Install as an autonomous Agent Skill using the standard skills CLI:

npx skills add https://github.com/steveyegge/beads

Standard agent skill installer compatible with Claude Code, Cursor, and agy harnesses.

Server Guidance & Instructions OpenAI & Claude Spec Compliant

Beads: Provides a lightweight memory system for coding agents through a graph-based issue tracker. Key capabilities: Zero setup with project-local database; Git-versioned JSONL records provide a distributed database across machines; Four types of dependency tracking (blocks, related, parent-child, discovered-from).

Codex and Claude read this instruction prompt during initialization to orchestrate cross-tool workflows and rate limits.

Top Core Functions

01 Zero setup with project-local database

02 Git-versioned JSONL records provide a distributed database

03 Automatic detection of ready-to-work issues