convez.ai
AgenteDevOps & InfraestruturaAvançado
sekai-dev-team

Claude Code para Yui

sekai-dev-team/claude-for-yui

Agent IA para codificação distribuída via NATS no ecossistema Hermes

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent headless baseado em Claude Code e NATS para ecossistema Hermes. Executa tarefas de codificação em containerização Docker com suporte a Python, Node.js e ferramentas de desenvolvimento completas. Funciona como worker descentralizado sincronizável entre ambientes.

Instalação

$npx convez-ai sekai-dev-team/claude-for-yui

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
37%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de desenvolvimento distribuído entre ambientes WSL e servidores
  • Execução remota de tarefas de codificação sem gerenciamento manual
  • Sincronização de workspace entre múltiplos hosts via Syncthing + Docker

Veredito

Solução robusta para arquiteturas multi-agent em containerização, com curva de aprendizado acentuada. Adequada para times que já operam Docker e NATS, exigindo configuração manual substancial de networking e sincronização.

README

A tradução para o português deste README ainda está na fila.

Claude Code for Yui 🐚

Yui 御用 Claude Code 容器镜像——NATS headless agent,Hermes 多智能体生态的核心编码工兵。

What's Inside

  • Claude Code CLI (@anthropic-ai/claude-code) — AI coding agent
  • NATS Headless Channel (@synadia-ai/nats-claude-code-headless) — makes Claude Code discoverable as a Synadia Agent on NATS
  • Bun — required by Claude Code Channels
  • Node.js 22 + Python 3.12 + Git + GitHub CLI — full dev toolchain

Docker Hub

Pre-built image: kona01zz/claude-agent

docker pull kona01zz/claude-agent

Deployment: devwsl (cc-developer + cc-evaluator-deployer)

Overview

Two CC agent containers on devwsl, sharing one workspace directory synced to tecent (hermes) via Syncthing.

devwsl
├── cc-developer            /workspace/projects ─┐
├── cc-evaluator-deployer   /workspace/projects ─┤── /home/kona/cc-workspace
└── syncthing-workspace ────────────────────────┘        │ Syncthing
                                                          ▼
tecent (hermes)                              /opt/data/workspace

1. Shared Workspace Directory

mkdir -p /home/kona/cc-workspace

2. CC Agents (docker-compose.devwsl.yml)

cp .env.example .env   # fill in ANTHROPIC_API_KEY
docker compose -f docker-compose.devwsl.yml up -d
  • cc-developer: no Docker socket, workspace at /workspace/projects
  • cc-evaluator-deployer: has /var/run/docker.sock, no WSL paths, workspace at /workspace/projects
  • Both connect to NATS at nats://100.121.2.51:4222 (tecent inner-docker)

3. Syncthing Workspace Sync (syncthing-workspace/docker-compose.yml)

cd syncthing-workspace
docker compose up -d

API available at http://127.0.0.1:8385 with key workspace-sync-devwsl.

After starting, pair with tecent (see below):

# Get devwsl device ID
curl -s -H 'X-API-Key: workspace-sync-devwsl' http://127.0.0.1:8385/rest/system/status \
  | python3 -c 'import sys,json; print(json.load(sys.stdin)["myID"])'

# Add tecent device
curl -X POST -H 'X-API-Key: workspace-sync-devwsl' -H 'Content-Type: application/json' \
  http://127.0.0.1:8385/rest/config/devices \
  -d '{"deviceID":"TECENT_DEVICE_ID","name":"tecent","addresses":["dynamic"],"compression":"metadata"}'

# Add shared folder
curl -X POST -H 'X-API-Key: workspace-sync-devwsl' -H 'Content-Type: application/json' \
  http://127.0.0.1:8385/rest/config/folders \
  -d '{"id":"cc-workspace","label":"CC Workspace","path":"/home/cc-workspace","type":"sendreceive","rescanIntervalS":30,"fsWatcherEnabled":true,"devices":[{"deviceID":"TECENT_DEVICE_ID"}]}'

Deployment: tecent (hermes docker-compose addition)

Add the following to hermes-docker-deployment/docker-compose.yml services section:

  syncthing-workspace:
    image: syncthing/syncthing:latest
    container_name: syncthing-workspace
    restart: unless-stopped
    volumes:
      - syncthing_workspace_config:/var/syncthing
      - /home/ubuntu/.hermes/workspace:/home/cc-workspace
    ports:
      - "127.0.0.1:8386:8384"
    environment:
      - STGUIAPIKEY=workspace-sync-tecent
    networks:
      - hermes-mcp

And to the volumes section:

  syncthing_workspace_config:

Then:

cd ~/hermes-docker-deployment
docker compose up -d syncthing-workspace

# Get tecent device ID
curl -s -H 'X-API-Key: workspace-sync-tecent' http://127.0.0.1:8386/rest/system/status \
  | python3 -c 'import sys,json; print(json.load(sys.stdin)["myID"])'

# Add devwsl device
curl -X POST -H 'X-API-Key: workspace-sync-tecent' -H 'Content-Type: application/json' \
  http://127.0.0.1:8386/rest/config/devices \
  -d '{"deviceID":"DEVWSL_DEVICE_ID","name":"devwsl","addresses":["dynamic"],"compression":"metadata"}'

# Add shared folder
curl -X POST -H 'X-API-Key: workspace-sync-tecent' -H 'Content-Type: application/json' \
  http://127.0.0.1:8386/rest/config/folders \
  -d '{"id":"cc-workspace","label":"CC Workspace","path":"/home/cc-workspace","type":"sendreceive","rescanIntervalS":30,"fsWatcherEnabled":true,"devices":[{"deviceID":"DEVWSL_DEVICE_ID"}]}'

Hermes accesses the synced workspace at /opt/data/workspace (via the existing /home/ubuntu/.hermes:/opt/data mount).


Environment Variables

VariableDescriptionDefault
ANTHROPIC_API_KEYAPI key (required)—
NATS_URLNATS server URLnats://nats-server:4222
NATS_OWNERNATS agent owner namekona
NATS_SESSIONNATS session namecc-builder
ANTHROPIC_BASE_URLAPI base URL (for proxies)https://api.deepseek.com/anthropic
ANTHROPIC_DEFAULT_OPUS_MODELDefault Opus modeldeepseek-v4-flash
ANTHROPIC_DEFAULT_SONNET_MODELDefault Sonnet modeldeepseek-v4-flash
ANTHROPIC_DEFAULT_HAIKU_MODELDefault Haiku modeldeepseek-v4-flash
DISABLE_AUTOUPDATERDisable Claude Code auto-update1

File Structure

.
├── Dockerfile                         # Image build
├── entrypoint.sh                      # NATS agent launcher
├── docker-compose.yml                 # Example (inner-docker / standalone)
├── docker-compose.devwsl.yml          # devwsl: cc-developer + cc-evaluator-deployer
├── syncthing-workspace/
│   └── docker-compose.yml             # devwsl: Syncthing workspace sync daemon
└── README.md
Ver o original no GitHub

Bom para

Relacionados