Instalação via APT
# Adicionar repositório (uma vez)
curl -fsSL https://rootkit.echosistema.com.br/releases/extensions/apt/gpg.pub \
| gpg --dearmor > /etc/apt/trusted.gpg.d/rtk.gpg
echo "deb https://rootkit.echosistema.com.br/releases/extensions/apt stable main" \
> /etc/apt/sources.list.d/rtk.list
apt update
# Instalar
apt install rtk-ai-box
Subcomandos
| Comando | Descrição |
|---|
rtk-ai-box install | Configura o devbox do zero |
rtk-ai-box install --usuario U --session S | Com usuário e sessão explícitos |
rtk-ai-box status | Health check: serviço, RAM, disco e MCPs |
rtk-ai-box status --json | Saída JSON para automação |
rtk-ai-box version | Exibe a versão instalada |
O que o install configura
| Etapa | Descrição |
|---|
| Sudo NOPASSWD | Permite operações sem senha para o serviço |
| Node.js LTS | Via NodeSource — necessário para MCPs npm |
| uv / uvx | Para MCPs baseados em Python |
| Claude Code | @anthropic-ai/claude-code via npm global |
| Workspace trust | Permite acesso irrestrito ao sistema de arquivos |
| claude-remote.service | Serviço systemd com restart automático |
Após o install
# 1. Autenticação (uma única vez)
claude
/login
# 2. Configure os MCP servers
# Template: /usr/share/rtk-ai-box/mcp-template.json
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /
claude mcp add sqlite -- uvx mcp-server-sqlite --db-path ~/data/devbox.db
# 3. Inicie o serviço
sudo systemctl start claude-remote
# 4. Verifique
rtk-ai-box status