К основному содержанию
плагин CX Codex

agent-deck — плагин для Claude Code: что делает и установка

agent-deck связывает MCP-сервисы, ключи и рабочие сценарии с выбранным проектом. Он пригодится, когда один процесс нужно повторять в Claude Code и Codex.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install agent-deck@awesome-codex-plugins
Открыть на GitHub

Что делает agent-deck

agent-deck объединяет MCP-сервисы, учётные данные и playbooks в колоды. Для каждой сессии агент получает выбранную колоду и видит только её контекст. Playbook может описывать выпуск пакета, открытие pull request, работу с тикетами или базой знаний. Изменения после исправлений оформляются как предложения, которые можно проверить в панели и принять.

В плагин входят четыре скилла: agent-deck-session, agent-deck-playbooks, agent-deck-setup и agent-deck-run. Он также подключает MCP-сервер через .mcp.json. Внешние серверы и API-ключи добавляются в панели, после чего карточки перетаскиваются в колоду. Для делегирования нужен agent-deck версии 2.1.0 или новее, запущенный daemon и установленный клиент, в который выполнен вход.

Для работы с секретами требуется macOS Keychain: Linux и Windows пока не поддерживаются для production-использования. Перед настройкой нужны Node.js 20+, npm и CLI agent-deck; панель запускается через agent-deck start и открывается командой agent-deck open.

Какие задачи решает

  • связать один playbook с Claude Code и Codex
  • собрать MCP-сервисы и ключи в колоду проекта
  • переключать контекст между рабочими пространствами
  • проверять предложения по изменению playbook
  • делегировать задачу агенту с ограниченными инструментами

Примеры запросов агенту

  • Настрой agent-deck и проверь, что CLI, daemon и вход в клиент готовы.
  • Создай колоду для проекта, добавь в неё playbook выпуска пакета и MCP-сервер для тикетов.
  • Используй скилл agent-deck-run, чтобы передать задачу колоде mydeck с файлом brief.md и инструментами только для чтения.

Как установить agent-deck

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install agent-deck@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы об agent-deck

Как установить agent-deck в Claude Code?

В Claude Code выполни /plugin marketplace add hashgraph-online/awesome-codex-plugins и затем /plugin install agent-deck@awesome-codex-plugins.

Что делает agent-deck?

Плагин связывает колоды с playbooks, MCP-сервисами и API-ключами. Агент получает выбранный контекст, а исправления playbook можно принять через предложения в панели.

На каких системах работает agent-deck?

Для production-использования требуется macOS, потому что секреты хранятся в macOS Keychain. Для делегирования также нужны agent-deck версии 2.1.0 или новее и запущенный daemon.

Исходный текст

agent-deck · MIT
# Agent Deck

[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

Keep the way you work consistent across coding agents and workspaces. Agent Deck gives every agent the right playbooks, tools, and credentials from one governed source of truth.

[![One playbook across coding agents — Agent Deck](https://img.youtube.com/vi/DVC70PgMY80/maxresdefault.jpg)](https://www.youtube.com/watch?v=DVC70PgMY80)

[Watch the 100-second overview](https://www.youtube.com/watch?v=DVC70PgMY80) — one playbook across agents and workspaces.

[Why](#why) · [Quick Start](#quick-start) · [How learning works](#how-learning-works) · [Delegate](#delegate-to-another-agent) · [Everyday commands](#everyday-commands) · [Docs](#documentation)

> **Bringing a friend (or starting cold)?** Follow the [one-page friend path](docs/FRIEND_PATH.md): cold machine → first deck switch → first Dealer issue.

## Why

You teach one coding agent how you work: how to open a PR, write a ticket, check a release, or use your knowledge base. Then you switch to another agent and teach it all again.

- **Consistency across agents.** The same playbook can guide Claude Code, Codex, Cursor, or another MCP client. You maintain one procedure instead of separate copies for every agent.
- **Consistency across workspaces.** Reusable PR rules, ticketing procedures, UI principles, and knowledge-base workflows live in one collection. Attach them to the decks that need them instead of duplicating them across repositories.
- **One governed source of truth.** A deck bundles the MCP services, credentials, and playbooks for one context. The agent sees only that deck. Switch decks instead of rewiring agents; improve a playbook once and reuse the lesson everywhere.

One MCP endpoint, registered once.

The execution half is [agent-dealer](docs/DIRECTION.md): queue tasks against a deck, approve the plan before anything runs, execute headless under budget caps, review results, and gate every outbound send — Dealer runs consume deck playbooks and file patch proposals back.

## Quick Start

> **macOS required.** API key secrets, OAuth client secrets, and OAuth tokens are stored in **macOS Keychain**. Linux and Windows are not supported for production use yet.

**Requirements:** Node.js 20+ · npm · Dashboard via `agent-deck start` / `agent-deck open` (listens on `127.0.0.1:1111`) · Agent Deck MCP `http://127.0.0.1:1110/mcp`

**1. Install and launch** (managed install — auto-updates, keeps existing `~/.agent-deck` data):

```bash
npx @agent-deck/cli@latest install
export PATH="$HOME/.local/bin:$PATH"
agent-deck start --daemon
```

**2. Register Agent Deck in your agent** (once per machine; `<client>` is `codex`, `cursor`, `claude`, or `muse`):

```bash
agent-deck setup --client <client>
```

Per-client details, restart and verify steps, and what `setup` installs: [Agent harness](docs/AGENT_HARNESS.md).

**3. Create a deck** in the dashboard (**My Decks** → create a deck → drag cards from **My Collection**), or ask the agent in chat to create one.

**4. Register playbooks (agent-first).** Describe the procedure in chat — e.g. *“Add a release checklist playbook with trigger ‘ship to npm’.”* Let the agent register it and attach it to your deck.

**5. Add external MCP servers and API keys** (Linear, Notion, Slack, …) in the dashboard — OAuth in the browser, API keys pasted once into Keychain — then drag the cards onto your deck.

**6. Pick a deck each session.** Tell the agent which deck — *“use the dev deck”*, or mid-session *“switch to my personal deck”* — and approve the switch as This session only or This workspace by default. Or run `agent-deck use <deck>` in a repo so the deck binds on session open without naming it.

Same decks on another machine: keep `~/.agent-deck/` in a private Git repository you own, push and pull it yourself, then run `agent-deck reindex` — see [Store format](docs/STORE_FORMAT.md).

## How learning works

When you correct a playbook-driven result, Agent Deck turns the lesson into a reviewable patch proposal so future sessions start from what you taught it. Corrections become **proposals** you review in the dashboard (Playbook patches); accepted changes update the deck. Every run makes the next one better.

If you use per-repo `use` stubs and playbook triggers changed, refresh with `agent-deck use --refresh`.

## Delegate to another agent

To delegate a task to a local agent session on a deck, `agent-deck run` launches a signed-in client bound to that deck:

```bash
agent-deck run mydeck --client claude --cwd /path/to/repo --prompt-file ./brief.md --tools readonly
```

Per-client flags, resume, and trust behavior: [DELEGATION.md](docs/DELEGATION.md).

## Install as an agent plugin

The repo root is one plugin: one `skills/` folder (`agent-deck-session`, `agent-deck-playbooks`, `agent-deck-setup`, `agent-deck-run`) plus `.mcp.json`, described by a manifest per client. Prerequisites for delegation: agent-deck >= 2.1.0 and the daemon running (see Quick Start), and the client CLI you delegate to, installed and signed in. The `agent-deck-setup` skill checks these and tells you what is missing.

| Client | Install | Manifest |
| --- | --- | --- |
| Claude Code | `/plugin marketplace add not-so-fat/agent-deck`, then `/plugin install agent-deck@agent-deck` | `.claude-plugin/plugin.json` + `marketplace.json` |
| Cursor | add `not-so-fat/agent-deck` as a plugin marketplace and install **agent-deck** | `.cursor-plugin/plugin.json` + `marketplace.json` |
| Codex | `codex plugin marketplace add not-so-fat/agent-deck`, then `codex plugin add agent-deck@agent-deck` | `.codex-plugin/plugin.json` (Codex reads the marketplace from `.claude-plugin/marketplace.json`) |
| muse | `agent-deck setup --client muse` (installs the four skills into `~/.config/muse/skills/`), or `muse plugins install <clone path>` (muse imports `.claude-plugin/plugin.json`) | `.claude-plugin/plugin.json` |

Skills are never copied by hand: the muse copies come from root `skills/` via `scripts/copy-muse-skills.mjs` at build time and `agent-deck setup --client muse` at install time.

### Cursor: setup and a test task

1. Install agent-deck and start it (Quick Start above): `npx @agent-deck/cli@latest install`, `agent-deck start --daemon`, then `agent-deck doctor`.
2. Install the **agent-deck** plugin from the Cursor Marketplace (or, for local testing, copy this repo to `~/.cursor/plugins/local/agent-deck` and run **Developer: Reload Window**). The plugin adds the four skills and the `agent-deck` MCP server (`agent-deck mcp-launch`, from `.mcp.json`); it needs the `agent-deck` CLI on `PATH` and stores no secrets.
3. Create a deck in the dashboard (`agent-deck open`), then bind a project folder: `agent-deck use <deck> --client cursor`, and reload Cursor.
4. **Test task:** open that folder and ask the agent: *"Use the agent-deck-setup skill to check my Agent Deck setup and tell me what is missing."* Expected: it runs read-only checks (`agent-deck --version`, `agent-deck status`, `agent-deck deck list`) and reports the result. Then try delegation: *"Use agent-deck-run to have a read-only claude session on deck <deck> list the files in this folder, and report its answer."* Expected: it launches `agent-deck run <deck> --client claude --tools readonly --detach`, polls `agent-deck run status`, and reports the session's answer with the `runId` and `sessionId`.

## Everyday commands

```bash
agent-deck start --daemon
agent-deck open             # re-open dashboard with a fresh auth cookie
agent-deck use <deck>       # bind this folder to a deck
agent-deck export all -o backup.agent-deck.json
agent-deck credential list
agent-deck exec --connections cred_id -- <command>
agent-deck upgrade
agent-deck stop
```

Port conflicts: `agent-deck status` · `agent-deck start --force`. Full environment reference: [Setup](docs/SETUP.md).

## Documentation

**Index:** [docs/README.md](docs/README.md) · **Security:** [SECURITY.md](SECURITY.md)

| Guide | Description |
|-------|-------------|
| [Friend path](docs/FRIEND_PATH.md) | Cold machine → first deck switch → first Dealer issue |
| [Direction](docs/DIRECTION.md) | Cross-product direction — agent_deck + agent-dealer |
| [Setup](docs/SETUP.md) | Ports, env vars, secrets, troubleshooting |
| [MVP](docs/MVP.md) | Source of truth — decks, vault, playbooks, MCP tools |
| [Agent harness](docs/AGENT_HARNESS.md) | What `setup` installs |
| [Delegation](docs/DELEGATION.md) | `agent-deck run` per-client reference |
| [Agent run API](docs/AGENT_RUN_API.md) | Same-host HTTP start, observe, cancel, and resume |
| [Playbooks vs Cursor skills](docs/PLAYBOOKS_AND_SKILLS.md) | Deck playbooks vs Cursor skills |
| [Export / import](docs/PRD_EXPORT_IMPORT.md) | Portable layout bundles |
| [Store format](docs/STORE_FORMAT.md) | File-backed store layout, sync, reindex |
| [Deck display](docs/PRD_DECK_DISPLAY.md) | Terminal status line |
| [Codex / Claude plugin](docs/CODEX_PLUGIN.md) | Marketplace packaging (HOL / Codex / Claude Code) |
| [Architecture](docs/ARCHITECTURE.md) | SQLite, Keychain, components |
| [Development](docs/DEVELOPMENT.md) | Contributors |
| [Publishing](docs/PUBLISHING.md) | npm release |

## License

MIT — see [LICENSE](LICENSE).

© not-so-fat · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
ansible-generator akin-ozer Скилл ansible-generator для Claude Code, который генерирует плейбуки, роли, задачи, инвентори и конфиги Ansible. Работает в режимах полной генерации, сниппетов и объяснений. CX Codex +1 952установок ae-capability ThinkingAIAgenticEngine Скилл ae-capability для Claude Code и Codex ищет возможности в шлюзе AE и запускает их через утилиту ae-cli. Вызывается для проверки схем и выполнения редких команд без готовых обёрток. CX Codex +1 945установок workflows-mcp-server cyanheads MCP-сервер workflows-mcp-server для Claude Code: хранит, ищет и создаёт сценарии работы для LLM-агентов в формате YAML. Фиксирует повторяющиеся цепочки вызовов инструментов. CX Codex +1 ★ 32звёзд репо Kadmo Kadmo-GmbH MCP-сервер Kadmo для Claude Code связывает среду разработки с агентами платформы Kadmo. Запускает задачи по тикетам, отслеживает их выполнение и обновляет плейбуки прямо из редактора. CX Codex +1 ansible-expert personamanagmentlayer Скилл ansible-expert помогает писать плейбуки Ansible, настраивать инвентари и шаблоны Jinja2. Пригодится при автоматизации серверов и оркестрации инфраструктуры. CX Codex +1 565установок deck-refresh официальный anthropics Скилл deck-refresh для Claude Code и других платформ обновляет числа в готовой презентации без пересборки слайдов. Вкатывает квартальные данные, earnings и пересчитанные метрики. CX Codex +1 1 800установок

Из того же набора391

Весь набор →
agentic-readiness-assessment Плагин agentic-readiness-assessment для Claude Code и Codex оценивает готовность репозитория к самостоятельной работе агента: по 14 критериям выдаёт scorecard и приоритетные исправления. CX Codex ★ 1 596звёзд репо agent-workflow-system Плагин agent-workflow-system с семью скиллами, которые превращают размытую задачу в пошаговый план, ведут проект от старта до сдачи и восстанавливают контекст после закрытия окна. CX Codex ★ 1 596звёзд репо agent-retro Плагин agent-retro для Claude Code и Codex собирает недельное ретро из 12 слайдов со статистикой и четырьмя подсказками по промптам для разбора собственных привычек. CX Codex ★ 1 596звёзд репо agent-harness-skills Плагин agent-harness-skills для Claude Code и Codex проектирует слой управления репозиторием, который нужен кодовым агентам: точки входа, границы, валидация, трассировка во время работы и записи о доставке кода. CX Codex ★ 1 596звёзд репо agent-guard Плагин agent-guard перехватывает вызовы инструментов, блокирует утечки ключей и маскирует токены в сессиях Claude Code и Codex. Работает локально без отправки телеметрии. CX Codex ★ 1 596звёзд репо agency-continuity-audit Плагин agency-continuity-audit проверяет постоянные рабочие пространства агентов: где есть доказательства цели, состояния и восстановления, а где только отчёт о здоровье. CX Codex ★ 1 596звёзд репо aegis Плагин aegis для Claude Code помогает агентам планировать изменения, применять TDD, отлаживать и собирать доказательства завершения задачи, исключая случайные правки. CX Codex ★ 1 596звёзд репо a-team Плагин a-team для Claude Code и Codex собирает в проекте команду из 26 специализированных агентов, рабочих скиллов и оркестратора. Он организует управляемые AI-кодинг-сессии. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой