Codecks Cli

codecks-cli

[](https://codecov.io/gh/rangogamedev/codecks-cli)

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 no official API or 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

Your agent can now use codecks-cli --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](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 | --stdin pipes (~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 --agent flag
• 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  mockup.png

See [docs/cli-reference.md](docs/cli-reference.md) for the full command reference.

How It Works

CLI (codecks-cli)  ─┐
Python API         ─┤── CodecksClient ── Codecks HTTP API
MCP Server         ─┘   (34 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](docs/ai-agent-guide.md#token-architecture) for details on each token.

Documentation

| Document | Contents | |----------|----------| | [docs/ai-agent-guide.md](docs/ai-agent-guide.md) | Full AI agent setup, CLI reference, MCP setup, customization | | [docs/cli-reference.md](docs/cli-reference.md) | CLI command reference and Python API | | [docs/mcp-reference.md](docs/mcp-reference.md) | MCP tool inventory, caching, error contract, team coordination | | [examples/](examples/) | Setup wizard, PM skill, game-dev agent example | | [AGENTS.md](AGENTS.md) | AI agent instructions (tokens, API pitfalls, known bugs) | | [DEVELOPMENT.md](DEVELOPMENT.md) | Architecture, dev setup, testing, release process | | [CONTRIBUTING.md](CONTRIBUTING.md) | How to contribute | | [CHANGELOG.md](CHANGELOG.md) | Version history |

Community

Questions? Ideas? Share your agent setup? Visit Discussions.

Contributing

Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).

License

MIT — see [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: rangogamedev
• Source: rangogamedev/codecks-cli
• License: MIT
• Homepage: https://github.com/rangogamedev/codecks-cli/blob/main/docs/ai-agent-guide.md

Install and usage instructions live in the source repository linked above.