Task tracker for coordinating AI agents with deadlines and state machine.
- Go 1.24+
- PostgreSQL 16+
go mod download
make buildConfigure via environment variables or command-line flags:
DATABASE_URL- PostgreSQL connection string (required)PORT- HTTP server port (default: 8080)LOG_LEVEL- Logging level: debug, info, warn, error (default: info)
export DATABASE_URL="postgres://user:password@localhost:5432/sloptask?sslmode=disable"
./bin/sloptask serveOr with custom port:
./bin/sloptask serve --port 3000./bin/sloptask check-deadlinesmake help # Show available commands
make build # Build the application
make run # Build and run the serve command
make clean # Remove build artifacts
make deps # Download and tidy dependenciesdocker-compose up -d db # Start PostgreSQL
docker-compose up server # Start the server
docker-compose down # Stop all servicesGET /healthz
Returns 200 OK if the application is running and the database is reachable.
cmd/sloptask/ - CLI entry point
internal/
├── config/ - Configuration constants
├── database/ - PostgreSQL connection + migrations
├── logger/ - Structured logging (slog)
└── handler/ - HTTP request handlers
See docs/ for detailed specifications:
SLOPTASK.md- Complete business logic specification01-INIT.md- Initialization phase requirements