AgentConsole

Central orchestration console for managing Claude Code sessions across multiple projects.

Features

• Multi-project session management - Launch and manage Claude Code sessions for any project
• Human and Agent command sources - Track whether commands originate from humans or agents
• Per-project cost tracking - Monitor API costs across all projects
• AgentWiki integration - Sync project documentation with AgentWiki

Quick Start

# Install dependencies
pip install -r requirements.txt

# Start the server
uvicorn src.app:app --port 8001 --reload

# Open in browser
open http://localhost:8001

Configuration

Edit config/projects.yaml to add/manage projects:

projects:
  - id: my-project
    name: My Project
    path: /path/to/project
    wiki_page: my-project-docs  # optional

Architecture

AgentConsole/
├── config/
│   └── projects.yaml          # Managed project configs
├── src/
│   ├── app.py                 # FastAPI main app
│   ├── models.py              # Pydantic models
│   ├── session_manager.py     # Multi-PTY session pool
│   ├── project_registry.py    # Project discovery/management
│   ├── wiki_integration.py    # AgentWiki sync
│   └── cost_tracker.py        # Per-project costs
├── static/
│   ├── css/console.css
│   └── js/console.js          # xterm.js multi-terminal
└── templates/
    └── console.html           # Main console page

API Endpoints

Endpoint	Method	Description
/	GET	Main console UI
/api/projects	GET	List all managed projects
/api/projects/discover	POST	Auto-discover Claude-enabled repos
/api/sessions	GET	List active sessions
/api/sessions	POST	Create new session
/api/sessions/{id}/command	POST	Send command to session
/api/costs	GET	Get cost summary
/ws/session/{id}	WS	Terminal WebSocket

License

MIT