codecks-cli MCP server
Commit 14. Nov. 2026Ermöglicht es einem AI Agent, Codecks.io Project Boards zu verwalten, indem er Cards erstellt, Standups durchführt und Game Development Tasks aufbaut.
Auch bekannt als rangogamedev/codecks-cli
- Stars
- 6
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 14. Nov. 2026
- Lizenz
- MIT
Was ist codecks-cli MCP?
codecks-cli ist ein MCP server. Ermöglicht es einem AI Agent, Codecks.io Project Boards zu verwalten, indem er Cards erstellt, Standups durchführt und Game Development Tasks aufbaut.
Zusammenfassung generiert aus dem README des Projekts
Über codecks-cli MCP server
Das Verwalten von Task Boards für die Spieleentwicklung wird durch codecks-cli für AI Agents und Entwickler, die Codecks.io nutzen, ermöglicht. Dieses Tool fungiert als Brücke für das Projektmanagement und erlaubt es einem Agent, administrative Aufgaben wie das Durchführen von Standups, Sprint Triage und das Aufbauen von Feature Cards zu übernehmen. Es ist darauf ausgelegt, Game Studios dabei zu unterstützen, Arbeit in Decks und Cards zu organisieren, ohne manuellen Overhead zu erzeugen.
Nutzer können den Server lokal über eine Python-Installation und einen offiziellen Codecks API Token mit Lese- und Schreibzugriff einrichten. Das System unterstützt verschiedene Interfaces, darunter ein eigenständiges CLI, eine Python API und einen MCP server. Während das CLI auf schlanken Context und JSON Output optimiert ist, bietet die MCP Implementierung fortgeschrittene Features wie Snapshot Caching, Team-Koordination durch Claim- oder Delegate-Aktionen sowie tiefere Editor-Integrationen für Tools wie Claude Code, Cursor und Windsurf.
Was du damit machen kannst
- 1Automatisierte Daily StandupsBitte deinen Agent, einen Snapshot des aktuellen Fortschritts zu erstellen, inklusive der Tasks, die erledigt, in Arbeit oder blockiert sind.
- 2Komplexe Game Features aufbauenLass den Agent eine Hero Card erstellen, die automatisch zugehörige Sub-Cards für Code, Design, Art und Audio generiert.
- 3Design Dokumente synchronisierenAnweisung an die KI, ein Game Design Document zu parsen und die entsprechenden Tasks in deinem Project Board zu erstellen.
- 4Multi-Agent Workflows koordinierenNutze den MCP server, um verschiedenen Agents zu ermöglichen, Tasks untereinander zu claimen, freizugeben oder zu delegieren.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Konfiguration
CODECKS_ATTACH_ALLOW_DIRS
| Name | Beschreibung | Typ |
|---|---|---|
| CODECKS_ATTACH_ALLOW_DIRS | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarrangogamedev/codecks-cli is public and reachablegithub.com/rangogamedev/codecks-cli ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-11github.com/rangogamedev/codecks-cli ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehencodecks-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 Fragen
Wie richte ich codecks-cli für meinen Agent ein?
Führe den interaktiven Setup-Befehl aus, der dich durch den Token-Prozess leitet. Danach kannst du deinen Agent Context mit dem agent-init Befehl initialisieren.
Was kann ein AI Agent mit diesem Tool machen?
Agents können Standups durchführen, Sprint Triage betreiben, Cards verwalten (erstellen, aktualisieren, archivieren), Feature Cards mit Sub-Cards aufbauen und Tasks über mehrere Agents hinweg koordinieren.
Wie nutze ich es mit MCP?
Du kannst die MCP Version gezielt über pip mit dem [mcp] Extra installieren.