@lycoiref/todo-context

CLI-first Agent context interface for ToDoNotion.

Install

npm install -g @lycoiref/todo-context

Usage

todo-context init --base-url "http://127.0.0.1:3001" --token "<token>"
todo-context doctor --json
todo-context status --json
todo-context search "sync issue" --json --limit 8
todo-context get task:<id> --json
todo-context get document:<id> --json
todo-context task create --title "Fix sync issue" --dry-run --json
todo-context document append document:<id> --content "new note" --json
todo-context memory add --title "Sync risk" --summary "..." --json
todo-context decision record --title "Use CLI first" --summary "..." --json
todo-context link create --from task:<id> --to decision:<id> --relation supports --json
todo-context pack create --goal "fix sync issue" --include task,document,memory,decision --format markdown
todo-context pack save --goal "fix sync issue" --json
todo-context pack list --json
todo-context install-agent all
todo-context install-agent all --check --json
todo-context install-agent all --upgrade
todo-context help --agent

Configuration

推荐先写入用户级配置：

todo-context init --base-url "http://127.0.0.1:3001" --token "<token>"
todo-context doctor --json

也可以通过环境变量覆盖：

export TODO_NOTION_API_BASE_URL="http://127.0.0.1:3001"
export TODO_NOTION_MCP_TOKEN="<token from AI / MCP access center>"

Agent Install

todo-context install-agent all

This writes project instructions for Claude Code, Codex, Gemini, and generic Agents so they know when to call todo-context.

Use --check to detect missing or stale project instructions, and --upgrade to refresh only the files that no longer match the current CLI templates. todo-context doctor --json also reports project Agent file status without making overall service health depend on whether Agent files are installed.