Ntasks is a task list that people and AI coding agents share. Your agents
pick up work, report progress and close tasks, recording proof such as a
commit or pull request, while you see who's working on what and answer
whatever needs you.
What it solves
- Agents forget where they left off. Each task keeps its branch, pull
request and next step, and a reconnecting agent is told what it holds.
- "Done" isn't always done. A closed task shows its proof or says "No
proof", and your repository's signals mark its change merged or live.
- It's hard to see what each agent is doing. Every task shows who holds
it, the helper agent working on it and when it last moved.
- Decisions get lost in chat. Everything that needs you is in one list,
and each decision takes one click.
- Task tools slow agents down. There's nothing to install in your
repositories, and claiming, commenting and closing take one call each.
Why Ntasks has the public reports behind each one.
Shipped or stalled, without asking
- Built → Merged → Live. Connect GitHub once, and a closed task moves to
Merged when its pull request merges and to Live when its deploy passes. No
agent reports either step. The merge can also close a task left in progress
on that pull request. Connect GitHub has the steps.
- Active → Quiet → Stalled. Each task in progress shows how recently its
holder changed or commented on it, and the web app's Live page groups them.
Agents list the same groups with
list_tasks, such as
activity: ["quiet", "stalled"] for work that may be done but not closed.
After a day with nothing, a task is Stalled, and a person can press Free
it so another agent can claim it.
The website shows both loops moving.
Get started
Ntasks runs on your own Cloudflare account, within
the free plan.
-
Deploy. On a machine with Node.js 22 or later, run:
npx ntasks deploy
It logs in to your Cloudflare account in the browser, deploys Ntasks
there, and prints its address and an AUTH_SECRET. Keep a copy of the
secret: the command shows it only once. Run it again to update to the
latest release.
-
Set up sign-in. Open /sign-in at the address people will use, such
as your custom domain, since sign-in is bound to it. Enter the
AUTH_SECRET the command printed and choose Create the GitHub App.
-
Create a workspace and a project, and invite people by GitHub
username.
The button deploys a copy of this repository instead, and that copy gets no
new releases.
To deploy with the button or from a checkout, or to run Ntasks on your
machine, see Deploy and run Ntasks.
Connect an agent
Run this on each machine your agents use:
curl -fsSL https://raw.githubusercontent.com/notice-cx/Ntasks/main/install.sh | bash
It asks for your Ntasks address and which agents to set up, connects Claude
Code, Codex CLI or Gemini CLI over MCP, and installs the Ntasks skill so each
agent keeps its work in Ntasks. Other MCP clients connect to
https://<your address>/api/mcp, as Connect an agent
describes.
Learn more
- Why Ntasks: the problems, with their sources.
- Concepts: projects, tasks, dependencies, claims,
decisions and approvals, and how Ntasks differs from Beads.
- The web app: every page, with animated walkthroughs.
- Deploy and run Ntasks: deploying, the first run and local
development.
- Connect an agent: the setup command, each agent by hand
and the Ntasks skill.
- For contributors: architecture and the workspace stores,
the API, sign-in,
the task store and
the design system.
- The Shared Work Protocol: a draft specification of
Ntasks's rules for shared work, which other task tools and agent harnesses
can implement.
Contributing
Contributions are welcome. CONTRIBUTING.md covers setup,
the checks to run and the pull request process. Please report
vulnerabilities privately, as SECURITY.md describes.
License
Copyright © 2026 Reindex Ventures LLC. Ntasks is licensed under the
GNU Affero General Public License, version 3 (AGPL-3.0-only);
see third-party notices for the work it builds on.
Claude is a trademark of Anthropic. OpenAI and Codex are trademarks of
OpenAI. Gemini is a trademark of Google LLC.
