codecks-cli MCPサーバー
コミット 2026年11月14日AIエージェントがCodecks.ioのプロジェクトボードを管理し、カードの作成、スタンドアップの実施、ゲーム開発タスクのスケルトン作成を行えるようにします。
別名 rangogamedev/codecks-cli
- スター
- 6
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月14日
- ライセンス
- MIT
codecks-cli MCPとは
codecks-cliはMCPサーバーです。 AIエージェントがCodecks.ioのプロジェクトボードを管理し、カードの作成、スタンドアップの実施、ゲーム開発タスクのスケルトン作成を行えるようにします。.
プロジェクトのREADMEから生成された概要
codecks-cli MCP server について
codecks-cliは、Codecks.ioを利用するAIエージェントや開発者が、ゲーム開発のタスクボードを管理できるようにするツールです。このツールはプロジェクト管理の架け橋として機能し、スタンドアップの実施、スプリントのトリアージ、機能カードのスケルトン作成といった管理業務をエージェントが処理できるようにします。ゲームスタジオが手動のオーバーヘッドなしに、作業をデッキやカードとして整理できるよう設計されています。
ユーザーは、Python環境と、読み取り・書き込み権限を持つ公式のCodecks APIトークンを使用して、ローカルにサーバーをセットアップできます。このシステムは、スタンドアロンのCLI、Python API、およびMCP serverを含むさまざまなインターフェースをサポートしています。CLIは軽量なコンテキストとJSON出力に最適化されていますが、MCP実装では、スナップショットのキャッシュ、claimやdelegateアクションによるチーム連携、さらにClaude Code、Cursor、Windsurfなどのツール向けの高度なエディタ統合などの高度な機能が提供されます。
できること
- 1デイリースタンドアップの自動化完了、進行中、またはブロックされているタスクを含む現在の進捗状況のスナップショットを生成するようエージェントに指示します。
- 2複雑なゲーム機能のスケルトン作成Heroカードを作成させ、それに関連するコード、デザイン、アート、オーディオ用のサブカードを自動生成させます。
- 3デザインドキュメントの同期AIにゲームデザインドキュメントを解析させ、プロジェクトボードに対応するタスクを作成させます。
- 4マルチエージェントワークフローの調整MCP serverを使用して、異なるエージェント間でタスクのclaim、release、またはdelegateを可能にします。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
設定
CODECKS_ATTACH_ALLOW_DIRS
| 名前 | 説明 | 種類 |
|---|---|---|
| CODECKS_ATTACH_ALLOW_DIRS | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能rangogamedev/codecks-cli is public and reachablegithub.com/rangogamedev/codecks-cli ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-11github.com/rangogamedev/codecks-cli ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るcodecks-cli
Native Journey tools are available experimentally. See the MCP reference for their internal-API limitations and validation status.
Game developers should be making games, not managing task boards.
codecks-cli gives your AI agent project management tools for Codecks.io — standups, feature scaffolding, sprint health, batch operations, and multi-agent coordination. Your agent handles the admin. You focus on the game.
Also works as a standalone CLI and Python API. Zero runtime dependencies.
What is Codecks?
Codecks is a card-based project management tool built for game studios — think Trello meets collectible card games. It organizes work into decks (boards), cards (tasks), and supports effort estimation, milestones, and team workflows. Codecks has an official API (since v2.96) but no CLI — codecks-cli fills that gap.
Agent Quick Start
pip install git+https://github.com/rangogamedev/codecks-cli.git
codecks-cli setup # walks you through tokens — no DevTools needed
codecks-cli agent-init --agent # verify: returns account + project context
Upgrading from 0.5 (Codecks v2.96)
Codecks now has official API tokens, and the old browser-cookie token has stopped working reliably (it is officially retired on 2026-12-31). Upgrading takes two minutes:
- In Codecks, open Your Profile → API Tokens, create a token with read & write access, and copy it (it is shown once; it starts with
cdxut_). - Run
codecks-cli setup, paste the token, and pick the deck new cards should go to. - Delete
CODECKS_REPORT_TOKENandCODECKS_ACCESS_KEYfrom your.env; they are no longer used.
Full migration guide — breaking changes, token best practices, troubleshooting: docs/migration-0.6.md. Summary: 0.6.0 changelog.
Your agent can now use codecks-cli <command> --agent via Bash. No special prompt needed — the CLI outputs stable JSON.
Want a plug-and-play PM skill? Copy examples/skills/pm/SKILL.md to .claude/commands/pm.md and use /pm.
Want MCP tools too? pip install "codecks-cli[mcp] @ git+https://github.com/rangogamedev/codecks-cli.git" — see docs/ai-agent-guide.md.
What Your Agent Can Do
- Run standups and sprint triage
- Create, update, archive, and batch-close cards
- Scaffold Hero cards with Code/Design/Art/Audio sub-cards
- Batch operations via
--ids-only | --stdinpipes (~40 bytes/card) - Sync tasks from a Game Design Document
- Coordinate multiple agents via MCP (claim/release/delegate)
Why CLI-First
The CLI is the recommended default for AI agents:
- 25x leaner context than loading 53 MCP tool schemas
- JSON output with
--agentflag - Pipe-friendly batch workflows (
--ids-only,--stdin,@last) - No MCP dependency needed for routine PM work
MCP adds caching, team coordination, and richer editor integrations when you need them.
Human Quick Start
codecks-cli cards --format table
codecks-cli standup --format table
codecks-cli create "Fix login bug" --deck Backlog
codecks-cli attach <uuid> mockup.png
See docs/cli-reference.md for the full command reference.
Attachments
attach (and create --file, and the attach_files MCP tool) only uploads files that resolve inside an allowed root. Allowed by default: the project root and the current working directory, plus any directory listed in CODECKS_ATTACH_ALLOW_DIRS (os.pathsep-separated — : on Unix, ; on Windows). Entries that are not absolute paths, are not existing directories, or name a whole filesystem root are ignored with a warning.
CODECKS_ATTACH_ALLOW_DIRS=/srv/art:/mnt/renders codecks-cli attach <uuid> /srv/art/hero.png
codecks-cli attach <uuid> hero.png --dry-run # resolved path + size + SHA-256, no upload
Dot-prefixed path components, credential-looking names (*.pem, *.key, id_rsa*, *token*, *secret*), and anything under /etc, /proc, or /sys are always refused. The MCP tool takes the same dry_run flag. Full rules: docs/cli-reference.md.
How It Works
CLI (codecks-cli) ─┐
Python API ─┤── CodecksClient ── Codecks HTTP API
MCP Server ─┘ (40 methods)
All three interfaces wrap the same CodecksClient library. The CLI formats output for terminals, the API returns dicts, and the MCP server adds caching, guardrails, and team coordination.
Features
- Card management — create, update, attach files, archive, delete with filtering by status, priority, deck, owner, milestone, tags, and text search
- Feature scaffolding — Hero cards with linked Code/Design/Art/Audio sub-cards
- Daily standups — done, in-progress, blocked, and in-hand snapshot
- Sprint health — blocked, stale, unassigned, and suggested next cards
- Batch operations — pipe workflows and MCP batch tools (up to 20 cards/call)
- Team coordination — claim/release/delegate across multiple agents (MCP)
- GDD sync — parse a Game Design Document and sync tasks to Codecks
- Snapshot caching — MCP reads in <50ms with selective invalidation
- 1000+ tests — full offline test suite, no live API calls
Setup
Run codecks-cli setup — it walks you through everything interactively. No manual token hunting required.
If you prefer manual setup, see .env.example for the configuration format and docs/ai-agent-guide.md for details on each token.
Documentation
| Document | Contents |
|---|---|
| docs/ai-agent-guide.md | Full AI agent setup, CLI reference, MCP setup, customization |
| docs/migration-0.6.md | Upgrading from 0.5.x: breaking changes, API token best practices, troubleshooting |
| docs/cli-reference.md | CLI command reference and Python API |
| docs/mcp-reference.md | MCP tool inventory, caching, error contract, team coordination |
| examples/ | Setup wizard, PM skill, game-dev agent example |
| AGENTS.md | AI agent instructions (tokens, API pitfalls, known bugs) |
| DEVELOPMENT.md | Architecture, dev setup, testing, release process |
| CONTRIBUTING.md | How to contribute |
| CHANGELOG.md | Version history |
Community
Questions? Ideas? Share your agent setup? Visit Discussions.
Contributing
Contributions welcome! See CONTRIBUTING.md.
License
MIT — see LICENSE.
codecks-cli MCPのよくある質問
エージェント用にcodecks-cliをセットアップするにはどうすればよいですか?
対話形式のセットアップコマンドを実行して、トークンの設定プロセスを進めてください。その後、agent-initコマンドを使用してエージェントのコンテキストを初期化できます。
このツールを使ってAIエージェントは何ができますか?
スタンドアップの実施、スプリントのトリアージ、カードの管理(作成、更新、アーカイブ)、サブカードを含む機能カードのスケルトン作成、および複数のエージェント間でのタスク調整が可能です。
MCPと一緒に使うにはどうすればよいですか?
pipを使用して、[mcp]エクストラを指定してMCPバージョンをインストールできます。