AgentPlaybooks

One playbook, every agent. A portable operating environment for AI agents — persona, skills, MCP servers, project instructions, and memory in one source of truth.

Keep your agents yours. AgentPlaybooks stores skills, personas, MCP servers, project instructions, and memory in one portable playbook, so you can switch platforms, use several at once, or self-host without vendor lock-in.

Your agent setup stays in sync across Claude, ChatGPT, Cursor, Codex, Gemini, local models, and future platforms. The playbook is the portable source of truth—not any single vendor or editor.

Highlights

• Personas: 1 per playbook, stored directly on the playbook record
• Skills: JSON schema definitions plus optional SKILL.md content
• Skill attachments: secure file storage for code, prompts, and docs
• MCP servers: tools and resources in Model Context Protocol format
• Canvas: versioned markdown work documents for long-running agent workflows
• Memory: key-value store with tags and descriptions
• Export formats: JSON, OpenAPI, MCP, Anthropic, Markdown
• API keys: Role-Based Access Control (Viewer, Coworker, Admin)
• Team collaboration: one-time editor invites without sharing human credentials or agent API keys
• Marketplace: Public and Unlisted playbooks, skills, MCP servers
• Theme: System-aware Light and Dark modes

Tech Stack

Category	Technology	Purpose
Framework	Next.js 15 + React 19	App Router, SSR
Styling	Tailwind CSS 4	Utility-first CSS
Animation	Framer Motion	UI animations
Icons	Lucide React	Icon library
API	Hono	Edge API routing
Database	Supabase	Postgres + Auth + RLS
i18n	next-intl	Localization
Docs	MDX	Markdown + React
Hosting	Cloudflare Pages	Edge deployment
Adapter	@opennextjs/cloudflare	Next.js on Workers

Live Demo

• Website: https://apbks.com
• Docs: https://apbks.com/docs
• GitHub: https://github.com/matebenyovszky/agentplaybooks

Getting Started

Prerequisites

• Node.js 20+
• npm or pnpm
• Supabase account
• Cloudflare account (optional for deployment)

Installation

git clone https://github.com/matebenyovszky/agentplaybooks.git
cd agentplaybooks
npm install

Environment Variables

Create a .env.local file with:

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

Development

npm run dev

Open http://localhost:3000

Cloudflare Deployment

npm run build:worker
npm run preview
npx wrangler deploy

CLI and Claude Code Plugin (packages/cli)

agentplaybooks doctor <project> audits local agent configuration (instructions, Agent Skills, MCP servers, likely hard-coded secrets, drift) and agentplaybooks sync <project> creates the canonical agentplaybook.json plus the platform files missing from enabled targets: Claude Code (.claude/skills + .mcp.json), Cursor (.cursor/skills + .cursor/mcp.json), ChatGPT/Codex (.codex/skills + .codex/config.toml), Google Antigravity (.agents/skills), and Hermes Agent (.agents/skills registered in ~/.hermes/config.yaml, plus that file's mcp_servers: and SOUL.md). login / playbooks / pull / push synchronize skills, MCP servers, and the manifest with a hosted playbook using a user API key; secret values never move, only the references the playbook declares in spec.secrets. All mutating commands are plan-only until --apply. See packages/cli/README.md.