The task manager for Gemini CLI

Give Google's Gemini CLI — the open-source terminal agent — a real task queue. TaskPrio is MCP-native: Gemini pulls the top task with get_next_task, edits files and runs commands in your terminal, reports a result, and grabs the next. One priority order, worked top to bottom — watched live in a cockpit.

Add it to Gemini

First fetch the bundled server and verify your token (one-time — grab the token from the TaskPrio sidebar → Copy token):

PROMPTPRIO_API_TOKEN=pp_xxx bash <(curl -fsSL https://taskprio.com/install.sh)

That caches the MCP server to ~/.local/share/promptprio/mcp-server.js. Now register it with Gemini. The Gemini CLI reads MCP servers from ~/.gemini/settings.json — add promptprio under mcpServers:

{
  "mcpServers": {
    "promptprio": {
      "command": "node",
      "args": ["/Users/you/.local/share/promptprio/mcp-server.js"],
      "env": {
        "PROMPTPRIO_API_TOKEN": "pp_your_token",
        "PROMPTPRIO_API_URL": "https://taskprio.com"
      }
    }
  }
}

Prefer the CLI? gemini mcp add writes the same entry. Start a new gemini session — run /mcp to confirm the TaskPrio tools loaded. Full steps in the docs.

The autopilot loop

1. get_next_task     → top unblocked task + merged project context
2. (Gemini edits files + runs commands in your terminal)
3. complete_task     → short result, logged for the audit trail
4. repeat            → until the queue returns no task

To run unattended, start Gemini in YOLO mode (gemini --yolo) so it auto-approves tool calls and clears the queue without a confirmation between tasks. Each handed-out task is leased, so Gemini can run beside a Claude Code, Cursor or Cline session on the same queue without collisions.

Why developers pair the Gemini CLI with TaskPrio

• No prompt babysitting — Gemini pulls the next task itself instead of you typing a new instruction after each completion.
• One source of truth — the same ranked queue you watch on the web cockpit is the one Gemini reads.
• Context travels with the task — per-project instructions, working directory and definition-of-done are merged into every task Gemini receives.
• You set priority — capture into the Inbox, rank what matters; Gemini only works ranked tasks, never an unfiltered pile.
• Honest by design — every completion records a result, so an unattended YOLO run leaves an audit trail you can scan later.

Frequently asked questions

How do I add a task queue to the Gemini CLI?

Run the one-line installer, then add the promptprio server under mcpServers in ~/.gemini/settings.json (or run gemini mcp add). Gemini then has get_next_task and complete_task.

Can it run unattended?

Yes — start Gemini with --yolo so it loops get_next_task → work → complete_task on your queue without a confirmation per step, the same autopilot loop Claude Code and Cursor use.

Can I run it next to Claude Code?

Yes. Tasks are leased on hand-out, so multiple agents pull from one priority order without grabbing the same task.

Is it free?

Yes. Free includes 1 MCP session and 50 completions/day; Pro ($10/mo) gives 5 sessions and unlimited completions — no per-agent fees, no extra tokens.

Start free — no card →   Using Claude Code? →   Codex CLI? →