BoardAgent

컴퓨터에서 실행되는 작업 관리자 — 당신 과 AI 에이전트를 위한. 터미널 UI, 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는 AI 모드, q는 종료입니다.

• 완전 키보드 우선: 화살표로 이동, 스페이스로 선택/열기, 엔터로 활성화.

• 설정 탭: 테마, 불투명도, 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 참조.