convez.ai
MCP ServerAutomaçãoAvançado
tsukasa-art

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 GitHub
InicialPluginScore · de 0 a 100

Aplicativo 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-sample

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

ToolTypeDescription
hiroba_currentreadCurrent operational state, active rooms, schedule
hiroba_roomsreadRoom list with latest messages
hiroba_roomreadFull room timeline and packet
hiroba_packetreadDecision packet for a room
hiroba_inboxreadMessages addressed to an actor, with since/auto filter
hiroba_inbox_ackwriteRecord read progress per room
hiroba_room_append_messagewriteAppend a validated message to a room

Status

Early development. Core features work; some areas are rough around the edges.

Ver o original no GitHub

Bom para

Relacionados