choda-deck

library0.2.3jsnpmunverified

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.

devops

npm install choda-deck

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CHODA-DECK

choda-deck

devopsjavascriptv0.2.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Configures choda-deck MCP server for Claude Code and shows CLI commands for task management.

// choda-deck is an MCP server, not a library — no code imports. // To use with Claude Code, create .claude.json: // { // "mcpServers": { // "choda-tasks": { // "command": "npx", // "args": ["-y", "choda-deck"], // "env": { // "CHODA_DATA_DIR": "/path/to/data", // "CHODA_CONTENT_ROOT": "/path/to/notes" // } // } // } // } // CLI usage (read-only): // choda-deck task list --status TODO --json // choda-deck task show TASK-669

Debug

Known issues

gotchaMCP configuration field names differ by client: Claude Code and Claude Desktop use 'mcpServers', Copilot uses 'servers' and requires '"type": "stdio"'.

fix

Check your MCP client's documentation for the correct JSON structure.

affects: >=0.0

gotchaCHODA_DATA_DIR and CHODA_CONTENT_ROOT must be absolute paths; relative paths may cause silent failures.

fix

Use absolute paths (e.g., /home/user/data, not ~/data).

affects: >=0.0

deprecatedNode.js <20 not supported; engine requirement is >=20.

fix

Upgrade Node.js to v20 or later.

affects: >=0.0

gotchaThe CLI is read-only; modifications can only be made via MCP tools (Claude cannot use CLI to create tasks).

fix

Use MCP client (e.g., Claude Code) to invoke tools for write operations.

affects: >=0.0

gotchaDatabase file location defaults to current working directory if CHODA_DATA_DIR is not set — may be unexpected when running via npx.

fix

Always set CHODA_DATA_DIR to an explicit absolute path.

affects: >=0.0

breakingVersion 0.x: breaking changes may occur at any minor/patch release without major version bump.

fix

Pin exact version (e.g., "choda-deck@0.2.3") in scripts or watch releases before updating.

affects: <1.0

Errors

Common errors & fixes

Error: Cannot find module 'choda-deck'

Missing global install or trying to require() as a library (it's an MCP server, not a module).

fix

Install globally via 'npm install -g choda-deck' or run with 'npx choda-deck'.

MCP server not showing tools in client

Wrong config field name or missing environment variables.

fix

Verify MCP config uses correct key (mcpServers vs servers) and that CHODA_DATA_DIR is set to a valid absolute path.

choda-deck: command not found

Package not installed or global bin not in PATH.

fix

Run 'npx choda-deck' or install globally: 'npm install -g choda-deck'.

Upgrade

Version history

0.2.3latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/butterngo/choda-deck ↗

packagechoda-deck ↗

homepagehttps://github.com/butterngo/choda-deck#readme ↗