convez.ai
SkillDevOps & InfraestruturaIniciante
zeroxaa

Join IMPO

zeroxaa/join-impo

Registre sua máquina no eng.impo.ai em um comando

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que registra a máquina local no eng.impo.ai, permitindo que sessões tmux apareçam no Command Center. Instalação em uma linha, autenticação por device-login do Google e suporte opcional a daemon (launchd/systemd).

Instalação

$npx convez-ai zeroxaa/join-impo

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á 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integrar máquina ao painel de controle tmux-mobile
  • Compartilhar sessões tmux com equipe via Google Workspace
  • Setup automático de agente persistente com systemd/launchd

Veredito

Skill bem focada para orquestração de máquinas em rede tmux. Implementação enxuta (arquivo único, sem dependências externas além de built-ins) e fluxo UX claro. Útil principalmente em contextos de eng.impo.ai; fora desse escopo tem valor limitado.

README

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

join-impo

A Claude Code skill that joins the current machine to https://eng.impo.ai so its tmux sessions show up in the Command Center. One-shot device-login, no repo clone required — the agent is a single bundled .mjs file.

What it does

When you say "join impo" (or "register this machine to eng.impo.ai") to Claude Code, the skill walks you through:

  1. Confirming node >= 20 and tmux are installed.
  2. Picking a name for this machine.
  3. Downloading a single-file agent (~165 KB) to ~/.local/share/join-impo/agent.mjs.
  4. Running Google device-login (you paste a 6-digit code into a browser).
  5. Optionally installing the agent as a launchd / systemd daemon so it survives reboots.
  6. Explaining who can see your machine (workspace vs. personal Google).

Total time: a minute or two.

Install the skill

Clone this repo into your Claude Code skills directory:

git clone https://github.com/zeroxaa/join-impo \
  ~/.claude/skills/join-impo

Then in any Claude Code session: "join impo" — or describe what you want, the skill description picks it up.

To update: git -C ~/.claude/skills/join-impo pull.

To uninstall: rm -rf ~/.claude/skills/join-impo.

Files

  • SKILL.md — the prompt Claude Code follows.

  • agent.mjs — the bundled tmux-mobile agent (single ESM file, only deps are node:* built-ins plus a bundled ws). This is what the skill downloads at install time. You can also run it directly without the skill:

    curl -fsSL https://raw.githubusercontent.com/zeroxaa/join-impo/main/agent.mjs -o /tmp/agent.mjs
    AGENT_MACHINE=my-mac node /tmp/agent.mjs --register https://eng.impo.ai --login
    
  • scripts/bundle.sh — how to re-bundle agent.mjs from a tmux-mobile checkout when the upstream agent changes.

Source

agent.mjs is an esbuild bundle of lib/agent.mjs

git clone https://github.com/cjzeroxaa/tmux-mobile
cd tmux-mobile && npm ci
node server.mjs --register https://eng.impo.ai --login

…without the clone and npm ci.

Visibility / permissions

Once registered, who can see your machine in the picker is decided by the Google account the agent logged in with:

  • Google Workspace (e.g. @rebyte.ai) → every Workspace teammate sees it.
  • Personal Google (e.g. @gmail.com) → only you see it.
  • Super-admins listed in SUPER_ADMIN_EMAILS on the controller see everything.

Full details: docs/join-network.md in the upstream repo.

License

MIT. Same as the upstream tmux-mobile bundle this packages.

Ver o original no GitHub

Bom para

Relacionados