v0.4.0 · MIT licensed · open source

Mission control for
AI coding agents.

A local, read-only panel that shows what your agent is actually doing.

CI 6 jobs green Python 3.11 – 3.13 Runtime deps none Tests 199 / 212 Licence MIT

Drag to orbit · the screen is a real capture

Live demo

The real thing, running.

A genuine recording of the dashboard on a sample plan.

8 layouts × 8 themes

64 combinations of the same honest state.

Conditional polling

ETag and 304.

Legacy view kept

Available at /legacy, forever.

The problem

Long agent runs are opaque.

You either interrupt the agent or tail a log.

Task Dashboard gives the run a surface instead.

~410Kinput tokens per hour
vs
0tokens per hour

An engineering estimate, not an API invoice.

What you get

Small surface. Strong guarantees.

Three properties are load-bearing.

Zero model tokens

ETag/304 conditional polling.

Zero runtime dependencies

Pure standard library.

Loopback only

Exact 127.0.0.1 origins.

Strictly read-only

Never writes a plan.

One tool, every harness

A single MCP server.

Honest states

Pending, Active, Review, Blocked, Complete.

Quickstart

Running in three commands.

Python 3.11 or newer.

Clone

git clone https://github.com/skarL007/task-dashboard.git
cd task-dashboard

Install

python -m pip install .

Serve

task-dashboard serve \
  --root /path/to/project

It prints one machine-readable line.

Connect your agent

One MCP server. Three harnesses.

Install the optional extra, then register the server.

Claude Codeverified
claude mcp add -s user task-dashboard -- \
  <python> -m task_dashboard mcp serve \
  --url http://127.0.0.1:55219/
OpenAI Codexverified
codex mcp add task-dashboard -- \
  <python> -m task_dashboard mcp serve \
  --url http://127.0.0.1:55219/
Antigravityverified
agy mcp add task-dashboard <python> -- \
  -m task_dashboard mcp serve \
  --url http://127.0.0.1:55219/

Three parameterless, read-only tools.

Security

Defended properties, not intentions.

Each is covered by a test.

Full threat model in SECURITY.md.

Straight talk

What it does not do.

Stated here rather than discovered later.

Known limitations

Open source

MIT, and set up for contributors.

Permissive licence and a documented contract.

  • LICENSE
  • CONTRIBUTING.md
  • SECURITY.md
  • CODE_OF_CONDUCT.md
  • CHANGELOG.md
  • .github/
MIT

Continuous integration