Planter
janek-moon/planter
Delegue tarefas Claude para sessões tmux/cmux com monitoramento automático
Ver no GitHubAgent 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/planter1 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
- 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
| Skill | Purpose |
|---|---|
planter:tenant | Entry point: detects tmux/cmux, finds or creates the named session, routes to a runner |
planter:tenant-claude | Runs the task under the claude CLI (default runner) |
planter:tenant-codex | Runs the task under the codex CLI |
planter:tenant-shell | Runs 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 buildto the build session as a plain shell command" - "Use codex for this one"
- "Fire and forget — just send it"
How it works
- Detect —
$TMUX/$CMUX_WORKSPACE_ID/ live-server probes pick the backend; nothing is assumed. - Resolve — the named session/workspace is reused if it exists, created and named if not.
- Inspect — the target screen is captured before any keystroke is sent; occupied panes are never overwritten.
- Run — the runner launches claude/codex or injects the sentinel-wrapped shell command.
- 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/codexCLIs 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