convez.ai
AgenteAutomaçãoIntermediário
janek-moon

Planter

janek-moon/planter

Delegue tarefas Claude para sessões tmux/cmux com monitoramento automático

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent que delega tarefas do Claude Code para sessões tmux/cmux nomeadas, permitindo executar claude, codex ou comandos shell em paralelo e monitorar resultados. Detecta automaticamente o backend de terminal disponível, reutiliza sessões existentes e captura a saída para relatar de volta.

Instalação

$npx convez-ai janek-moon/planter

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
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Executar testes em sessões tmux dedicadas enquanto continua codificando
  • Corrigir erros de lint com claude em background em uma sessão nomeada
  • Rodar builds e deploys como comandos shell delegados com relatório de resultado
  • Usar codex para tarefas específicas em sessão isolada

Veredito

Agent robusto para delegar workloads paralelos em ambientes locais com tmux/cmux. Implementação defensiva (não sobrescreve panes ocupados, detecta automaticamente o backend) torna-o seguro para fluxos de desenvolvimento. Requer setup local de tmux/cmux e CLIs (claude/codex), viável para quem já usa essas ferramentas.

README

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

planter 🌱

English · 한국어

Delegate tasks from a Claude Code session to named tmux or cmux sessions — find or create the session, run claude (default), codex, or a plain shell in it, monitor the screen, and report the result back.

Install

/plugin marketplace add janek-moon/planter
/plugin install planter@planter

Skills

SkillPurpose
planter:tenantEntry point: detects tmux/cmux, finds or creates the named session, routes to a runner
planter:tenant-claudeRuns the task under the claude CLI (default runner)
planter:tenant-codexRuns the task under the codex CLI
planter:tenant-shellRuns a plain shell command with sentinel-based completion detection

Usage

Just ask Claude Code:

  • "Run the tests in the build session" / "build 세션에서 테스트 돌려줘"
  • "Create a session called deploy and have claude fix the lint errors there"
  • "Delegate npm run build to the build session as a plain shell command"
  • "Use codex for this one"
  • "Fire and forget — just send it"

How it works

  1. Detect — $TMUX / $CMUX_WORKSPACE_ID / live-server probes pick the backend; nothing is assumed.
  2. Resolve — the named session/workspace is reused if it exists, created and named if not.
  3. Inspect — the target screen is captured before any keystroke is sent; occupied panes are never overwritten.
  4. Run — the runner launches claude/codex or injects the sentinel-wrapped shell command.
  5. Monitor — the screen is polled until the completion signal fires and output stabilizes, then the result is summarized. Fire-and-forget skips this on request.

Safety rules

  • Never boots a tmux/cmux server on its own.
  • Never types over a pane occupied by another program.
  • Never answers trust/permission/login dialogs in the delegated session without explicit user authorization.

Requirements

  • tmux and/or cmux
  • Claude Code with plugin support; claude / codex CLIs on PATH for those runners

Manual verification checklist

  • tmux: delegate to a NEW named session (claude runner, monitored)
  • tmux: delegate to an EXISTING session (reused, not recreated)
  • cmux: delegate to a new named workspace
  • codex runner end-to-end (verified to the approval/usage-limit checkpoint)
  • shell runner: sentinel DONE and FAIL paths
  • fire-and-forget: injection confirmed, no monitoring afterwards

License

MIT

Ver o original no GitHub

Bom para

Relacionados