Taskbase¶
A lightweight task management system built for agent-native workflows. Deployed to the Skatzi cluster in the tools namespace.
Overview¶
Taskbase has two microservices:
- api/ — REST API in Go. Owns all business logic, database access, and authentication.
- ui/ — React SPA served via nginx. Handles Keycloak OIDC login and calls the API.
The system lets an operator queue tasks with titles, descriptions, and priorities. An AI agent then picks them up autonomously, transitions them through a lifecycle, and reports results back — without the operator being present.
Dependencies¶
| Dependency | Purpose |
|---|---|
| CloudNativePG | PostgreSQL 16 for task persistence |
| Keycloak | OIDC login for the UI |
| External Secrets Operator | Injects DATABASE_URL, API_KEY, GITEA_TOKEN from OpenBao |
Exposed Services¶
| Service | URL |
|---|---|
| UI + API | https://taskbase.skatzi.com |
| API (agent access) | https://taskbase.skatzi.com/api |
| Swagger UI | https://taskbase.skatzi.com/api/docs |