BoardAgent

Менеджер задач, который живет на вашем компьютере — для вас и ваших ИИ-агентов. Терминальный интерфейс, REST API, MCP-сервер. Бесплатно, локально, без облака.

Установка (Windows)

Вам нужны готовые exe-файлы. Два способа их получить:

Вариант A — используйте релизные бинарники (проще всего): Скачайте последний релиз с GitHub → распакуйте → дважды щелкните INSTALL.bat. Вот и всё. Он копирует программы, настраивает автозапуск, устанавливает сторожевой процесс и добавляет приложение в ваш PATH.

Вариант B — соберите их сами: Требуется 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/

Затем запустите INSTALL.bat.

Related MCP server: pith

Запуск

Windows (после INSTALL.bat): дважды щелкните boardagent.exe (или введите boardagent в терминале). Фоновый сервер автоматически запускается при входе в систему.

Где угодно (из исходников):

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

Советы для первого запуска:

• Нажмите c для создания задачи, a для режима ИИ, q для выхода.

• Полное управление с клавиатуры: стрелки перемещают, пробел выбирает/открывает, Enter активирует.

• Вкладка настроек: тема, непрозрачность, ключи API, привязки клавиш.

Позвольте ИИ-агенту использовать доску

Укажите вашему MCP-хосту (Claude Desktop, Cursor, Hermes) на boardagent-mcp:

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

Создайте ключ API в Настройках → Ключи API для всего остального.

Как это работает

• REST API — источник истины, http://127.0.0.1:7373.

• MCP-сервер — тонкий адаптер поверх того же сервисного слоя.

• Textual TUI — приложение, которое вы видите, общается с сервисом через localhost.

• Данные хранятся в ~/.boardagent/boardagent.db (SQLite). Всё локально.

Документация

• Для людей: docs/human/ — введение, настройка MCP, темы, упаковка.

• Для ИИ-агентов: docs/agent/ — оптимизированные по токенам справочники REST + MCP.

• Инженерные решения: DECISIONS.md.

Разработка

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

Лицензия

MIT — см. LICENSE.