# Agent Tracker

One place that maps every task to the agent that owns it: the owning agent, its live state, the task status and the latest note. A Python service serves the board, a JSON API and MCP; agents update it by CLI or MCP, the public subdomain is read-only.

**Status:** Live · Projects · None

- **Local checkout:** `/Users/simon/Developer/agent-tracker` (branch `main`, last commit e37ee7d, 2026-11-07 — agent-tracker: task <-> agent tracker with HTTP API, MCP and CLI)
- **Uncommitted changes:** 3 file(s) at brief generation time
- **Repository:** https://github.com/ShimonNavon/agent-tracker
- **On another machine:** `git clone https://github.com/ShimonNavon/agent-tracker` — the paths below are Simon's Mac
- **Live:** https://agents.navonsimon.com/
- **How it works:** https://projects.navonsimon.com/agent-tracker.html
- **Where it runs:** namespace agent-tracker · NodePort 30126 · public agents.navonsimon.com (read-only) · MCP http://ubuntu03:30126/mcp
- **Note:** Read-only publicly; agents write over the tailnet, MCP or CLI

## Stack

Python stdlib, SQLite, MCP over HTTP, Single-file HTML, Kubernetes

## Start here

- `server.py` — the whole backend: SQLite store, JSON API, MCP, static serving
- `tracker.html` — the tracker UI (fetches /api/tasks, writes with the key)
- `seed.json` — first-run rows when the store is empty
- `cli/agent-tracker` — the CLI: list, show, set, note, add, done, summary
- `deploy/app.yaml, deploy.sh, edge.conf, route_domain.py` — cluster, edge nginx and Cloudflare route
- `site/agent-tracker.html` — the write-up page on projects.navonsimon.com

## Commands

- **Run locally:** `PORT=8080 DATA_DIR=./data STATIC_DIR=. ACCESS_KEY=dev python3 server.py`
- **Tests:** `python -m unittest discover -s tests`
- **Deploy:** `./deploy/deploy.sh`
- **Deploy edge:** `./deploy/deploy.sh edge`

## Deploy and where it runs

- Namespace agent-tracker, NodePort 30126 on ubuntu04 (kubectl via ubuntu03).
- Code (server.py, tracker.html, seed.json) from ConfigMap app; tasks in SQLite on a 1Gi local-path PVC.
- Edge conf on ubuntu01 (edge-nginx), Cloudflare route agents.navonsimon.com via deploy/route_domain.py.

## Current state

Live. Public host is a read-only view (Cloudflare blocks POST); agents write over the tailnet, MCP or CLI.

## Watch out

- Cloudflare on navonsimon.com blocks POST, so the public host is GET/HEAD only; writes go over the tailnet.
- The UI tries POST for status/notes; over the public host that returns 405. Use http://ubuntu03:30126/ or the CLI to edit.
- Reads need the access key too (x-access-key header, ?key= or key body field).

## Secrets — locations only, never print values

- ACCESS_KEY in agent-tracker/.env and the cluster Secret agent-tracker-env; the CLI reads ~/.config/agent-tracker/key

## Tags

Python, MCP, CLI, SQLite, Kubernetes

---

Brief generated 2026-11-08 from `~/Developer/my-projects/context/`. Canonical URL: https://projects.navonsimon.com/context/agent-tracker.md
