README [early pilot]

todoless

Task backend. HTTP + MCP.

A shared queue for small teams and side projects. Tasks, dependencies, review and weekly hours.

Use HopKit in a browser, or bring your own tools. Todoless keeps the task state.

// Hosted access is a small pilot. Existing accounts required.

Read your queue

Personal API key. Workspace permissions. Your assignments by default.

HTTP / curlGET
curl --fail-with-body \
  "https://todoless.dev/v1/workspaces/$WORKSPACE_ID/delivery/queue" \
  -H "Authorization: Bearer $TODOLESS_API_KEY"
MCP tooldelivery.queue({ workspace_id })

Set the two shell variables to your own workspace ID and personal key. The MCP line shows the tool and its arguments.

What's implemented

queue
One active task per person in a workspace. Up to two Ready alternatives across projects. Stable task IDs and assignees.
handoffs
Dependencies, blocker notes, Review and Verify steps. Returned work keeps the reason.
hours
Manual time entries. One weekly submission across projects. Owner approval and CSV export. Submitted and approved hours stay separate.
history
Version checks on writes and an audit trail. Progress notes stay with the task when you pause and resume.

// Hours are records, not invoices. Payments stay manual.

Project notes

We're building this for our own projects and collaborations. Plans kept getting buried in chat. We wanted a shared queue we could also use from scripts and assistants.

Task delivery and weekly hours are being tested with a small team. Public browser signup isn't available yet. Setup instructions are in the repo.

stack
TypeScript / Hono / Cloudflare Workers / D1
license
Apache-2.0
bugs
Open an issue with what you tried and what happened.