{"id":44560,"library":"choda-deck","title":"choda-deck","description":"Pure-Node MCP server providing SQLite-backed task, session, conversation, and knowledge orchestration for Claude Code. Current stable version 0.2.3, updated irregularly. Gives Claude persistent memory across sessions — task tracking, session checkpoints, structured decisions with ADRs, inbox for mid-flow ideas, and daily auto-backups. Key differentiators: no cloud/telemetry, single SQLite file, fully offline, designed specifically to solve Claude Code's statelessness. Competes with manual markdown notes or cloud task managers but stays local and agent-accessible via MCP tools.","status":"active","version":"0.2.3","language":"javascript","source_language":"en","source_url":"https://github.com/butterngo/choda-deck","tags":["javascript","mcp","model-context-protocol","claude-code","task-tracking","sqlite","agent-orchestration"],"install":[{"cmd":"npm install choda-deck","lang":"bash","label":"npm"},{"cmd":"yarn add choda-deck","lang":"bash","label":"yarn"},{"cmd":"pnpm add choda-deck","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[],"quickstart":{"code":"// choda-deck is an MCP server, not a library — no code imports.\n// To use with Claude Code, create .claude.json:\n// {\n//   \"mcpServers\": {\n//     \"choda-tasks\": {\n//       \"command\": \"npx\",\n//       \"args\": [\"-y\", \"choda-deck\"],\n//       \"env\": {\n//         \"CHODA_DATA_DIR\": \"/path/to/data\",\n//         \"CHODA_CONTENT_ROOT\": \"/path/to/notes\"\n//       }\n//     }\n//   }\n// }\n\n// CLI usage (read-only):\n// choda-deck task list --status TODO --json\n// choda-deck task show TASK-669","lang":"typescript","description":"Configures choda-deck MCP server for Claude Code and shows CLI commands for task management."},"warnings":[{"fix":"Check your MCP client's documentation for the correct JSON structure.","message":"MCP configuration field names differ by client: Claude Code and Claude Desktop use 'mcpServers', Copilot uses 'servers' and requires '\"type\": \"stdio\"'.","severity":"gotcha","affected_versions":">=0.0"},{"fix":"Use absolute paths (e.g., /home/user/data, not ~/data).","message":"CHODA_DATA_DIR and CHODA_CONTENT_ROOT must be absolute paths; relative paths may cause silent failures.","severity":"gotcha","affected_versions":">=0.0"},{"fix":"Upgrade Node.js to v20 or later.","message":"Node.js <20 not supported; engine requirement is >=20.","severity":"deprecated","affected_versions":">=0.0"},{"fix":"Use MCP client (e.g., Claude Code) to invoke tools for write operations.","message":"The CLI is read-only; modifications can only be made via MCP tools (Claude cannot use CLI to create tasks).","severity":"gotcha","affected_versions":">=0.0"},{"fix":"Always set CHODA_DATA_DIR to an explicit absolute path.","message":"Database file location defaults to current working directory if CHODA_DATA_DIR is not set — may be unexpected when running via npx.","severity":"gotcha","affected_versions":">=0.0"},{"fix":"Pin exact version (e.g., \"choda-deck@0.2.3\") in scripts or watch releases before updating.","message":"Version 0.x: breaking changes may occur at any minor/patch release without major version bump.","severity":"breaking","affected_versions":"<1.0"}],"env_vars":null,"search_vec":"'0.2.3':25 'access':85 'across':32 'adr':41 'agent':84,103 'agent-access':83 'agent-orchestr':102 'auto':51 'auto-backup':50 'back':12 'backup':52 'checkpoint':37 'choda':2 'choda-deck':1 'claud':20,29,66,96 'claude-cod':95 'cloud':76 'cloud/telemetry':56 'code':21,67,97 'compet':70 'context':93 'convers':15 'current':22 'daili':49 'decis':39 'deck':3 'design':62 'differenti':54 'file':59 'flow':46 'fulli':60 'give':28 'idea':47 'inbox':42 'irregular':27 'javascript':89 'key':53 'knowledg':17 'local':81 'manag':78 'manual':72 'markdown':73 'mcp':7,87,90 'memori':31 'mid':45 'mid-flow':44 'model':92 'model-context-protocol':91 'node':6 'note':74 'offlin':61 'orchestr':18,104 'persist':30 'protocol':94 'provid':9 'pure':5 'pure-nod':4 'server':8 'session':14,33,36 'singl':57 'solv':65 'specif':63 'sqlite':11,58,101 'sqlite-back':10 'stabl':23 'stateless':69 'stay':80 'structur':38 'task':13,34,77,99 'task-track':98 'tool':88 'track':35,100 'updat':26 'version':24 'via':86","created_at":"2026-06-07T12:50:44.642880+00:00","updated_at":"2026-06-07T12:50:44.642880+00:00","problems":[{"fix":"Install globally via 'npm install -g choda-deck' or run with 'npx choda-deck'.","cause":"Missing global install or trying to require() as a library (it's an MCP server, not a module).","error":"Error: Cannot find module 'choda-deck'"},{"fix":"Verify MCP config uses correct key (mcpServers vs servers) and that CHODA_DATA_DIR is set to a valid absolute path.","cause":"Wrong config field name or missing environment variables.","error":"MCP server not showing tools in client"},{"fix":"Run 'npx choda-deck' or install globally: 'npm install -g choda-deck'.","cause":"Package not installed or global bin not in PATH.","error":"choda-deck: command not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/butterngo/choda-deck#readme","github":"https://github.com/butterngo/choda-deck","docs":null,"changelog":null,"pypi":null,"npm":"choda-deck","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}