tendon-cli

Task tracking that lives inside Claude Code.

Set up Tendon in one command — no manual config, no JSON files, no account required.

npx tendon-cli

What it does

Tendon connects Claude Code to a task tracker. Once set up, you can talk to Claude naturally:

"What should I focus on today?"
"Create a task: fix the auth bug, high priority"
"Start a focus session on the login refactor"
"What did I do yesterday?"
"/wrap_up"

Claude creates tasks, tracks time, runs standups, and gives you daily summaries — all from inside your editor.

Quick start

npx tendon-cli

The wizard will ask:

How do you want to run Tendon?
▸ Docker  (recommended — PostgreSQL included)
  Manual  (bring your own PostgreSQL)
  Cloud   (tendon.alashed.kz — free account)

Docker (recommended) — starts everything automatically:

• PostgreSQL
• API server
• MCP server

Requires Docker Desktop to be running.

Manual — if you already have PostgreSQL running somewhere.

Cloud — no install. Use the hosted version at tendon.alashed.kz.

After setup

The wizard prints the command to connect Claude Code:

claude mcp add --transport http tendon http://localhost:3002

Run it, open Claude Code, and type:

tendon whoami

Claude will open a browser → click Allow → connection confirmed.

First things to say in Claude

/morning                                    — start your day
"create 3 tasks for today"                  — bulk task creation
"start focus on [task]"                     — begin time tracking
"mark [task] as done"                       — complete a task
"what did I do yesterday?"                  — daily summary
/wrap_up                                    — end of day recap
/standup                                    — yesterday / today / blockers
/review                                     — weekly productivity review

MCP tools available

| Tool | Description | |------|-------------| | whoami | Verify connection, show user + workspace | | create_task | Create task with title, priority, due date | | list_tasks | List tasks filtered by status | | update_task | Edit title, description, priority | | update_task_status | Move to planned / in_progress / done | | archive_task | Remove from active list | | start_focus_session | Start timer (auto-stops previous) | | stop_focus_session | Stop and log duration | | get_today_plan | In-progress + planned + time tracked | | get_daily_summary | Summary for any date, supports "yesterday" | | week_summary | 7-day breakdown with focus bars | | log_blocker | Append blocker note to a task |

Requirements

• Node.js ≥ 20
• Docker Desktop (for Docker mode)
• Claude Code

Use the hosted version instead

If you don't want to self-host:

claude mcp add --transport http tendon https://mcp.tendon.alashed.kz

1. Create a free account
2. Run the command above
3. Claude opens a browser — click Allow

Full web dashboard, team features, Telegram daily reports.

Links

• Website: tendon.alashed.kz
• GitHub: github.com/Alashed/tendon-mcp
• npm: npmjs.com/package/tendon-cli

License

MIT