convez.ai
MCP ServerIntegração & APIsIntermediário
rangogamedev

Codecks CLI — Gerenciamento de Projetos para IA

rangogamedev/codecks-cli

52 ferramentas MCP para automação de gestão de projetos Codecks com agentes IA

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server que expõe 52 ferramentas para integrar Codecks.io (plataforma de gestão de projetos para estúdios de jogos) com agentes IA. Oferece CLI eficiente em tokens, API Python nativa e suporte a coordenação multi-agente, eliminando overhead administrativo de desenvolvedores.

Instalação

$npx convez-ai rangogamedev/codecks-cli

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
3
Acompanhando
0
Saúde
100%
Último commit
há 2 dias
Versão
v0.6.0
Issues abertas
4
Contribuidores
3

Casos de uso

  • Automatizar standups e triagem de sprints com agentes IA
  • Criar e gerenciar cards de tarefas em batch via CLI ou API
  • Coordenar múltiplos agentes para delegação de trabalho
  • Sincronizar Game Design Documents com board de projetos
  • Scaffold de cartões Hero com sub-cartões estruturados

Veredito

Solução especializada e bem-testada (1000+ testes) para studios de jogos que usam Codecks e querem delegar gerenciamento de projetos a agentes IA. CLI-first reduz consumo de tokens em 25x comparado a MCP puro. Maduro e production-ready com suporte a Claude Code, Cursor e Windsurf.

README

A tradução para o português deste README ainda está na fila.

codecks-cli

Native Journey tools are available experimentally. See the MCP reference for their internal-API limitations and validation status.

Python 3.12+ License: MIT Tests: 1000+ CI codecov

Claude Code Cursor Windsurf

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:

  1. 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_).
  2. Run codecks-cli setup, paste the token, and pick the deck new cards should go to.
  3. Delete CODECKS_REPORT_TOKEN and CODECKS_ACCESS_KEY from 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 | --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 <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         ─┘   (41 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

DocumentContents
docs/ai-agent-guide.mdFull AI agent setup, CLI reference, MCP setup, customization
docs/migration-0.6.mdUpgrading from 0.5.x: breaking changes, API token best practices, troubleshooting
docs/cli-reference.mdCLI command reference and Python API
docs/mcp-reference.mdMCP tool inventory, caching, error contract, team coordination
examples/Setup wizard, PM skill, game-dev agent example
AGENTS.mdAI agent instructions (tokens, API pitfalls, known bugs)
DEVELOPMENT.mdArchitecture, dev setup, testing, release process
CONTRIBUTING.mdHow to contribute
CHANGELOG.mdVersion history

Community

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

Contributing

Contributions welcome! See CONTRIBUTING.md.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados