codecks-cli MCP server
2026년 11월 14일 커밋AI 에이전트가 Codecks.io 프로젝트 보드를 관리하며 카드를 생성하고, 스탠드업 미팅을 진행하며, 게임 개발 작업을 구조화할 수 있도록 지원합니다.
다른 이름 rangogamedev/codecks-cli
- 스타
- 6
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- MIT
codecks-cli MCP란?
codecks-cli은(는) MCP server입니다. AI 에이전트가 Codecks.io 프로젝트 보드를 관리하며 카드를 생성하고, 스탠드업 미팅을 진행하며, 게임 개발 작업을 구조화할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
codecks-cli MCP server 정보
codecks-cli는 Codecks.io를 사용하는 개발자와 AI 에이전트가 게임 개발 작업 보드를 관리할 수 있게 해줍니다. 이 도구는 프로젝트 관리를 위한 가교 역할을 하며, 에이전트가 스탠드업 미팅 진행, 스프린트 트리아지, 기능 카드 구조화와 같은 관리 업무를 처리할 수 있도록 돕습니다. 게임 스튜디오가 수동 작업 없이 데크(deck)와 카드(card) 단위로 업무를 정리할 수 있도록 설계되었습니다.
사용자는 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 에이전트로 무엇을 할 수 있나요?
스탠드업 미팅 진행, 스프린트 트리아지(triage), 카드 관리(생성, 업데이트, 아카이브), 하위 카드를 포함한 기능 카드 구조화, 여러 에이전트 간의 작업 조율이 가능합니다.
MCP와 함께 사용하려면 어떻게 해야 하나요?
pip를 사용하여 [mcp] extra 옵션과 함께 MCP 버전을 설치할 수 있습니다.