BoardAgent

Eine Aufgabenverwaltung, die auf deinem Computer lebt — für dich und deine KI-Agenten. Terminal-UI, REST-API, MCP-Server. Kostenlos, lokal, keine Cloud.

Installation (Windows)

Du brauchst die vorgefertigten EXE-Dateien. Zwei Möglichkeiten, sie zu bekommen:

Option A — die Release-Binaries verwenden (am einfachsten): Lade die neueste Version von GitHub herunter → entpacken → doppelklicke INSTALL.bat. Das war's. Es kopiert die Programme, richtet den Autostart ein, installiert einen Watchdog und fügt die App zu deinem PATH hinzu.

Option B — selbst bauen: Erfordert Python 3.10+.

pip install -e .          # installs the 3 CLI commands
python scripts/build_exes.py   # builds boardagent.exe, boardagent-server.exe, boardagent-mcp.exe into dist/

Führe dann INSTALL.bat aus.

Related MCP server: pith

Ausführen

Windows (nach INSTALL.bat): Doppelklicke boardagent.exe (oder tippe boardagent in ein Terminal). Der Hintergrundserver startet automatisch bei der Anmeldung.

Überall (Quellcode):

boardagent-server   # terminal 1 — the background service
boardagent          # terminal 2 — the task board UI

Tipps für den ersten Start:

• Drücke c, um eine Aufgabe zu erstellen, a für den KI-Modus, q zum Beenden.

• Vollständig tastaturbasiert: Pfeile bewegen, Leertaste wählt aus/öffnet, Enter aktiviert.

• Einstellungen-Tab: Design, Deckkraft, API-Schlüssel, Tastenkürzel.

Einem KI-Agenten die Nutzung des Boards ermöglichen

Richte deinen MCP-Host (Claude Desktop, Cursor, Hermes) auf boardagent-mcp aus:

{
  "mcpServers": {
    "boardagent": { "command": "C:\\path\\to\\boardagent-mcp.exe" }
  }
}

Erstelle für alles andere einen API-Schlüssel unter Einstellungen → API-Schlüssel.

So funktioniert es

• REST-API — maßgebliche Quelle, http://127.0.0.1:7373.

• MCP-Server — dünner Adapter über derselben Dienstschicht.

• Textual-TUI — die App, die du siehst, kommuniziert über localhost mit dem Dienst.

• Daten liegen in ~/.boardagent/boardagent.db (SQLite). Alles lokal.

Dokumentation

• Für Menschen: docs/human/ — Einführung, MCP-Einrichtung, Designs, Paketierung.

• Für KI-Agenten: docs/agent/ — token-optimierte REST- und MCP-Referenzen.

• Entwicklungsentscheidungen: DECISIONS.md.

Entwicklung

python -m pytest
python scripts/generate_agent_docs.py   # needs the server running
python scripts/build_exes.py            # Windows exes into dist/

Lizenz

MIT — siehe LICENSE.