convez.ai
AgenteDevOps & InfraestruturaIntermediário
hiochiai

InBox

hiochiai/inbox

Sandbox Docker seguro para agentes de IA sem instalação local

Ver no GitHub
InicialPluginScore · de 0 a 100

Sandbox containerizado que isola a execução de agentes de IA como Claude Code e Antigravity CLI em ambientes Docker seguros. Elimina a necessidade de instalar dependências localmente no host, oferecendo suporte multi-perfil e acesso completo a comandos de forma isolada.

Instalação

$npx convez-ai hiochiai/inbox

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 mês
Versão
v0.19.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Executar agentes de IA em ambientes isolados e seguros
  • Gerenciar múltiplos perfis de autenticação e configurações de projetos
  • Manter host limpo sem instalar Node.js ou dependências específicas de agentes
  • Integração em pipelines CI/CD com segurança

Veredito

Solução bem pensada para quem trabalha com agentes de IA em produção e precisa de isolamento seguro. A arquitetura Docker-first é sólida, embora exija familiaridade com containers e perfis de configuração.

README

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

InBox

InBox is a containerized sandbox wrapper for AI agents like Antigravity CLI and Claude Code. It provides a secure, isolated environment for AI interactions without requiring local installation of Node.js or agent-specific dependencies.

[!WARNING] The Gemini agent is deprecated.

Why InBox?

  • 🔒 Secure Isolation: AI agents run in isolated Docker containers
  • 🧹 Clean Host System: No need to install Node.js or dependencies locally
  • ⚡ Full Command Access: Containerized environment supports all commands safely
  • 👤 Multi-Profile Support: Easy switching between authenticated users and project configurations
  • 🚀 Zero Setup: Just Docker required - everything else is handled automatically

Prerequisites

  • Docker (running and accessible)

Installation

# Download and install InBox
curl -L -o inbox https://github.com/hiochiai/inbox/releases/latest/download/inbox
chmod +x inbox
sudo mv inbox /usr/local/bin/

# Verify installation
inbox version

Usage

Documentation Matrix

TopicAntigravity CLIClaude CodeGemini CLI (Deprecated)
Getting StartedGuideGuideGuide
Google Cloud ProjectGuide-Guide
Creating ProfilesGuideGuideGuide
Switching ProfilesGuideGuideGuide
Set Default ProfileGuideGuideGuide
Passing ArgumentsGuideGuideGuide
Using Memory FilesGuideGuideGuide
Custom Tools (DooD)GuideGuideGuide
Optional Settings-Guide-

Common Topics

Configuration

InBox uses a profile concept to manage settings for each AI. This allows you to switch between different configurations for various tasks or projects.

Directory Structure

InBox stores configurations in ~/.inbox/ with the following structure:

~/.inbox/
├── antigravity/               # Default Antigravity profile
│   └── .gemini/
│       ├── antigravity-cli/...
│       └── GEMINI.md         # Optional memory file
├── claude/                   # Default Claude profile  
│   └── .claude/
│       ├── settings.json
│       └── CLAUDE.md         # Optional memory file
├── claude-personal/          # Named profile example
│   └── .claude/...
├── gemini/                   # Default Gemini profile
│   └── .gemini/
│       ├── settings.json
│       └── GEMINI.md         # Optional memory file
└── gemini-work/              # Named profile example
    └── .gemini/...

Each profile directory is mounted to /home/inbox inside the container, allowing agents to access their configurations seamlessly.

Troubleshooting

Common Issues

Docker Permission Errors

# Ensure Docker is running and accessible
docker ps

# On Linux, add user to docker group
sudo usermod -aG docker $USER
# Then logout and login again

Authentication Issues

# Clear profile and re-authenticate
rm -rf ~/.inbox/claude
inbox claude  # Start fresh setup

Profile Not Found

# List available profiles
inbox profile list

# Check profile path
inbox profile claude my-profile

Uninstallation

# Remove InBox binary
sudo rm /usr/local/bin/inbox

# Remove all configurations and profiles
rm -rf ~/.inbox

# Remove Docker image
docker images --format "{{.Repository}}:{{.Tag}}" \
  | grep '^ghcr.io/hiochiai/inbox:' \
  | xargs docker rmi

[!WARNING] Removing ~/.inbox will delete all your profiles and authentication data.

Ver o original no GitHub

Bom para

Relacionados