Ntasks Get started

Ntasks · Open source, on your own Cloudflare account

One task list for you and your AI agents.

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.

Get started Read the docs

Works with Claude Code, Codex CLI, Gemini CLI and any other MCP client.

The Ntasks board: Waiting for you lists an approval with an Approve button, two decisions with their options and a task with an Answer button; below it are two tasks in progress, one of them worked on by a helper agent, and four open tasks. The Ntasks board: Waiting for you lists an approval with an Approve button, two decisions with their options and a task with an Answer button; below it are two tasks in progress, one of them worked on by a helper agent, and four open tasks.

01 / What it solves

Every agent's work. In one list.

The problems people and agents run into when they share work, and what Ntasks does about each one.

  • 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

02 / See it work

Answer, approve. See what shipped.

Recorded in the web app with its invented example tasks.

Pick an option and answer. The work your decision held becomes ready for an agent to claim.

The cursor picks the recommended option of a decision in Waiting for you, the decision leaves the list, and the task that waited on it moves from Blocked to Open with its Claim button. The cursor picks the recommended option of a decision in Waiting for you, the decision leaves the list, and the task that waited on it moves from Blocked to Open with its Claim button.

03 / Get started

Your own Ntasks. In three steps.

Ntasks runs on your own Cloudflare account, within the free plan.

  1. 1Deploy

    Deploy to your Cloudflare account. The button asks for one secret, AUTH_SECRET. Make one and keep a copy:

    openssl rand -base64 32
    Deploy to Cloudflare

  2. 2Set 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 secret and choose Create the GitHub App.

  3. 3Create a workspace and a project

    Then invite people by GitHub username.

On a new deployment's setup page, the cursor types the AUTH_SECRET, which shows masked, and presses Create the GitHub App. On a new deployment's setup page, the cursor types the AUTH_SECRET, which shows masked, and presses Create the GitHub App.

To deploy from a checkout, update a deployment or run Ntasks on your machine, see Deploy and run Ntasks

Connect an agent

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.

Connect an agent has the steps for each agent

Run this on each machine your agents use:

curl -fsSL https://raw.githubusercontent.com/notice-cx/Ntasks/main/install.sh | bash

04 / Docs

Read the docs.

From why Ntasks exists to the API, for people who use it and people who build on it.

Start here

Run Ntasks

Reference for contributors