BoardAgent

あなたのコンピュータ上で動作するタスクマネージャー — あなたとAIエージェントのための。 ターミナルUI、REST API、MCPサーバー。無料、ローカル、クラウド不要。

インストール (Windows)

ビルド済みのexeが必要です。 入手方法は2つあります：

オプション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 でAIモード、q で終了。

• 完全キーボードファースト：矢印で移動、スペースで選択/開く、Enterでアクティブ化。

• 設定タブ：テーマ、不透明度、APIキー、キーバインド。

AIエージェントにボードを使わせる

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設定、テーマ、パッケージング。

• AIエージェント向け: 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 を参照。