BoardAgent

Un gestor de tareas que vive en tu ordenador — para ti y tus agentes de IA. Interfaz de terminal, API REST, servidor MCP. Gratuito, local, sin nube.

Instalación (Windows)

Necesitas los ejecutables precompilados. Hay dos formas de obtenerlos:

Opción A — usar los binarios de la versión (la más fácil): Descarga la última versión desde GitHub → descomprime → haz doble clic en INSTALL.bat. Eso es todo. Copia los programas, configura el inicio automático, instala un vigilante y añade la aplicación a tu PATH.

Opción B — compilarlos tú mismo: Requiere 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/

Luego ejecuta INSTALL.bat.

Related MCP server: pith

Ejecutar

Windows (después de INSTALL.bat): haz doble clic en boardagent.exe (o escribe boardagent en una terminal). El servidor en segundo plano se inicia automáticamente al iniciar sesión.

En cualquier lugar (desde el código fuente):

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

Consejos para la primera vez:

• Pulsa c para crear una tarea, a para el modo IA, q para salir.

• Totalmente orientado al teclado: las flechas mueven, la barra espaciadora selecciona/abre, Enter activa.

• Pestaña de ajustes: tema, opacidad, claves de API, atajos de teclado.

Deja que un agente de IA use el tablero

Apunta tu host MCP (Claude Desktop, Cursor, Hermes) a boardagent-mcp:

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

Crea una clave de API en Ajustes → Claves de API para cualquier otra cosa.

Cómo funciona

• API REST — fuente de verdad, http://127.0.0.1:7373.

• Servidor MCP — adaptador ligero sobre la misma capa de servicio.

• TUI Textual — la aplicación que ves, habla con el servicio a través de localhost.

• Los datos viven en ~/.boardagent/boardagent.db (SQLite). Todo local.

Documentación

• Para humanos: docs/human/ — introducción, configuración de MCP, temas, empaquetado.

• Para agentes de IA: docs/agent/ — referencias REST + MCP optimizadas para tokens.

• Decisiones de ingeniería: DECISIONS.md.

Desarrollo

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

Licencia

MIT — consulta LICENSE.