Hiroba – Gerenciador de Colaboração com Agentes IA
tsukasa-art/hiroba-sample
Desktop macOS + MCP server para orquestração colaborativa de agentes IA
Ver no GitHubAplicativo macOS que funciona como espaço de trabalho centralizado para orquestração de agentes IA (Claude Code e Codex), com salas de chat estruturadas, feed de atividades, fila de tarefas e servidor MCP integrado. Permite sincronização bidirecional entre Claude Desktop e workflows locais através de ferramentas MCP padronizadas.
Instalação
npx convez-ai tsukasa-art/hiroba-sample1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerenciar conversas estruturadas entre múltiplos agentes IA e usuário
- Integrar Claude Code e Codex em workflows de desenvolvimento locais
- Rastrear decisões de agentes, gates e histórico operacional em append-only logs
- Agendar e monitorar tarefas com status real-time via fila integrada
Veredito

Solução especializada em fase experimental para usuários macOS que precisam orquestrar colaboração entre agentes IA em workflows determinísticos. MCP server bem integrado com Claude ecosystem, mas codebase em desenvolvimento com documentação mínima — recomendado para adotantes iniciais confortáveis com Swift e arquitetura de agentes.
README
A tradução para o português deste README ainda está na fila.
Hiroba
Personal Mac desktop app for managing AI agent collaboration workflows (Claude Code + Codex).
Work in progress. Built for personal use.
What it does
- Room Chat — Structured conversation between Claude, Codex, and the user, stored as append-only JSONL
- Activity Feed — Operational log of agent work, decisions, and gates
- Schedule — Task queue with status tracking
- Prompt panel — Next prompt drafting and routing to Claude/Codex
- MCP server — Read/write tools so Claude Code and Claude Desktop can access Hiroba rooms directly
Requirements
- macOS 14+
- Swift 6.3+
- Claude Code (optional, for MCP integration)
Setup
1. Config file
Create ~/.config/hiroba.json:
{
"develop_root": "/path/to/your/Develop",
"notes_root": "/path/to/your/Notes"
}
Defaults to ~/Develop and ~/Develop/Notes if the file is missing.
2. Build and install
swift build -c release --product Hiroba
cp .build/release/Hiroba /path/to/Hiroba.app/Contents/MacOS/Hiroba
Or use the included script:
./scripts/build-app.sh
3. MCP server (optional)
Build the MCP server and register it with Claude Code:
swift build -c release --product HirobaMCP
claude mcp add hiroba --scope user -- /path/to/hiroba/.build/release/HirobaMCP
Set HIROBA_ROOT environment variable to override the project root:
HIROBA_ROOT=/path/to/hiroba HirobaMCP
Data layout
hiroba/
Sources/ # App and MCP server source
Tests/ # Test suite
scripts/ # Build and packaging scripts
data/ # Runtime data — gitignored
rooms/ # Room chat files
activity-log.jsonl
schedule-log.jsonl
prompts/
MCP tools
| Tool | Type | Description |
|---|---|---|
hiroba_current | read | Current operational state, active rooms, schedule |
hiroba_rooms | read | Room list with latest messages |
hiroba_room | read | Full room timeline and packet |
hiroba_packet | read | Decision packet for a room |
hiroba_inbox | read | Messages addressed to an actor, with since/auto filter |
hiroba_inbox_ack | write | Record read progress per room |
hiroba_room_append_message | write | Append a validated message to a room |
Status
Early development. Core features work; some areas are rough around the edges.