famdeck

Famdeck

Autonomous development toolkit. Closed-loop workflow: discover work, execute it, validate quality, sync status — all through slash commands inside your coding sessions.

Famdeck is a multi-repo ecosystem of plugins and CLIs:

Component	What it does	Type
famdeck (this repo)	Autopilot, autonomy assessment, E2E testing, scaffolding, session management	Claude Code plugin + OpenClaw plugin
famdeck-relay	Issue routing, bidirectional sync, handoffs across trackers	Claude Code plugin
famdeck-atlas	Project registry, cross-project awareness, session context	Claude Code plugin
famdeck-toolkit	Setup automation, project init, service management	Claude Code plugin

Connects Beads (issue tracking), BMAD (sprint methodology), and AI agents into a single workflow.

---

Installation

Step 0: Prerequisites

Install the AI coding CLI and session manager before anything else.

AI Coding CLI (required — pick one)

Option	What it is	Install
Claude Code	Anthropic's official CLI	npm install -g @anthropic-ai/claude-code
OpenCode + Oh My OpenCode	Open-source alternative with Claude Code plugin compatibility	See OpenCode docs and Oh My OpenCode README

Oh My OpenCode adds a Claude Code compatibility layer to OpenCode, so Claude Code plugins (Atlas, Relay, Beads, etc.) work in both environments.

Codeman (required)

Codeman provides persistent tmux-based sessions, a multi-session web dashboard, respawn controller for unattended work, and desktop notifications.

curl -fsSL https://raw.githubusercontent.com/Ark0N/Codeman/master/install.sh | bash

Requires: Node.js 18+, tmux.

OpenClaw (recommended)

OpenClaw is an AI assistant platform. Famdeck is an OpenClaw plugin natively — installing it unlocks 9 additional session management skills not available in Claude Code alone (see Skills Reference).

npm install -g openclaw@latest
openclaw onboard --install-daemon

Requires: Node.js 22+.

---

Step 1: Standalone CLIs

These are CLI tools used by the plugins. Install them first.

# Dolt — git-for-data, required by Beads
brew install dolt                # macOS
# Linux: curl -L https://github.com/dolthub/dolt/releases/latest/download/install.sh | sudo bash

# Beads — git-backed issue tracker
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

# beads-ui — browser kanban board for Beads issues
npm install -g beads-ui

# uv — Python package manager, required by Serena and Agent Mail
curl -LsSf https://astral.sh/uv/install.sh | sh

Verify:

dolt version && bd version && bdui --version && uvx --version

---

Step 2: Claude Code Plugins

If using Claude Code (or OpenCode + Oh My OpenCode):

# Add the private marketplace
claude plugin marketplace add iVintik/private-claude-marketplace

# Core famdeck plugins
claude plugin install famdeck@ivintik
claude plugin install famdeck-atlas@ivintik
claude plugin install famdeck-relay@ivintik

# Beads plugin (issue tracking slash commands)
claude plugin marketplace add steveyegge/beads
claude plugin install beads

# Code intelligence
claude plugin install context7@claude-plugins-official
claude plugin install serena@claude-plugins-official

# OR install everything at once via the toolkit:
claude plugin install famdeck-toolkit@ivintik
# Then in a regular terminal (not inside Claude Code):
python3 ~/.claude/plugins/cache/ivintik/famdeck-toolkit/*/scripts/setup.py --non-interactive

The toolkit also installs and manages Agent Mail (multi-agent coordination MCP server). See famdeck-toolkit README for details.

Restart Claude Code after installing plugins.

---

Step 3: OpenClaw Plugin (optional, recommended)

If you installed OpenClaw:

cd /path/to/famdeck
openclaw plugins install .

This registers famdeck as an OpenClaw plugin, unlocking session management skills (/session-*, /project-add) in addition to the core skills available in Claude Code.

---

Step 4: Project Initialization

Navigate to any project and run inside Claude Code:

/toolkit-init