Kontur: an explicit project dashboard for agents, scripts and people

Description and use

Kontur is a lightweight self‑hosted dashboard that stores an explicit roadmap with milestone dependencies, acceptance criteria, and evidence references, enabling clear separation of project status components.

Problem

Project status labels often mix developer reports, test results, and owner acceptance, making it hard to track progress separately.

Outcome

Kontur enables explicit project tracking with a lightweight, self‑hosted dashboard, allowing separate handling of roadmap, milestones, and acceptance criteria, and supports concurrent updates and optional Git integration.

Workflow

• Clone the Kontur repository
• Create a virtual environment and install dependencies
• Run run.py to start the server
• Open http://127.0.0.1:8766 and enter the API key from data/api-token.txt
• Create or import a project JSON file
• Edit the JSON in an editor and re‑import to preserve history
• Use the API for concurrent updates with If‑Match headers
• Optionally use the PowerShell collector to preview Git refs

Evidence

Kontur is a small self-hosted dashboard for that workflow. It stores an explicit roadmap with milestone dependencies, acceptance criteria and evidence references.

Source

The API records supplied statements; it does not certify that work is correct.

Source

The default server binds to loopback. Direct network binding requires an explicit host allowlist and TLS; a trusted HTTPS proxy with a loopback backend is another option.

Source