T2A

Control plane for agent-heavy workflows. When execution shifts to agents, orchestration needs a shared home—not only the IDE. T2A is that layer: Postgres tasks, an append-only audit trail, REST (/tasks), and SSE (GET /events) so UIs and runners refetch on hints instead of polling.

Module: github.com/AlexsanderHamir/T2A
Documentation: docs/README.md (index: product, API, web, troubleshooting) · CONTRIBUTING.md · SECURITY.md · AGENTS.md

Prerequisites

• Go 1.25+
• Postgres and a repo-root .env (gitignored) with DATABASE_URL — copy from .env.example

Build and test

go build ./...
go test ./...

Full local verification (gofmt, go vet, go test, web/ test + build): .\scripts\check.ps1 (Windows) or ./scripts/check.sh (Unix). To run only Go steps, set CHECK_SKIP_WEB=1 (see AGENTS.md).

Run

go run ./cmd/dbcheck    # DB check; add -migrate to apply schema
go run ./cmd/taskapi    # HTTP server; -h for -port, -env, -logdir, -loglevel, -disable-logging (T2A_DISABLE_LOGGING=1 for no JSONL, errors only to stderr)

API + web together

From the repo root, scripts/dev.ps1 (Windows) or scripts/dev.sh installs web/ deps, builds taskapi to taskapi-dev(.exe), frees the API port, starts taskapi then npm run dev. Ctrl+C stops both.

For a non-default API port, set DEV_TASKAPI_PORT and VITE_TASKAPI_ORIGIN to match (see Web UI below).

.\scripts\dev.ps1

chmod +x ./scripts/dev.sh   # once if needed
./scripts/dev.sh

By default taskapi listens on http://127.0.0.1:8080 with REST /tasks and SSE /events. For synthetic SSE during UI work, set T2A_SSE_TEST=1 and optional T2A_SSE_TEST_INTERVAL (default 3s; 0 disables the ticker). Behavior and limits: docs/DESIGN.md.

Windows PowerShell: use curl.exe and single-quoted JSON:

curl.exe -s -X POST http://127.0.0.1:8080/tasks -H "Content-Type: application/json" -d '{"title":"live"}'
curl.exe -N http://127.0.0.1:8080/events

Web UI (optional)

Vite + React + TypeScript SPA — layout, React Query, SSE invalidation: docs/WEB.md.

cd web
npm install
npm test
npm run dev

Opens Vite (often http://localhost:5173). Proxy targets /tasks, /events, /repo → taskapi (web/vite.config.ts). Override with VITE_TASKAPI_ORIGIN if the API is not http://127.0.0.1:8080.

Command	Purpose
npm run dev	Dev server + proxy
npm test	Vitest (no real network; mocks)
npm run test:watch	Watch mode
npm run build	Typecheck → web/dist/
npm run preview	Preview dist (you still need API routing)

Production: build static assets; serve dist same-origin as the API or behind a reverse proxy (taskapi does not serve dist). No CORS in the binary — docs/DESIGN.md (limitations).

For developers

• AGENTS.md — repo map, checks, pitfalls
• CONTRIBUTING.md — PRs, API / parseTaskApi sync
• Extend the tasks stack: docs/DESIGN.md (Extensibility) and .cursor/rules/13-tasks-stack-extensibility.mdc
• Workspace repo (REPO_ROOT, /repo): docs/DESIGN.md (Optional workspace repo), .cursor/rules/14-repo-workspace-extensibility.mdc
• Large Cursor-assisted edits: .cursor/rules/00-full-rules-pass.mdc (see CONTRIBUTING)

go doc -all ./pkgs/tasks/...
go doc -all ./internal/envload ./cmd/taskapi ./cmd/dbcheck

License

MIT.