opencode.sh_
Un lugar seguro donde pensar, construir y operar. El contenedor es una base equipada: tus carpetas locales, primero.
cada proyecto corre en su propia instancia, con sesiones, snapshots y logs aislados.
La máquina local no debería ser parte del experimento.
Cuando trabajamos en una idea, instalar toolchains, pelear con versiones, mezclar credenciales o dejar rastros en el sistema son distracciones que rompen el ritmo.
Aislado
Cada proyecto corre en su propio contenedor. El entorno local queda tal como estaba.
Reproducible
Una base equipada siempre igual. No empezás de cero cada vez.
Completo
Todo el toolchain y los agentes especializados ya dispuestos a trabajar.
Un opencode completo, sin ensuciar tu máquina.
opencode completo y familiar
Mismos agentes base build y plan, y toda la configuración global compartida entre proyectos.
Cuatro entornos integrados
Python, JavaScript, TypeScript y Rust listos para usar, sin instalación previa.
Herramientas de apoyo
Redes, DevOps, control de versiones, automatización y auditoría ya presentes.
Agentes especializados
Del día a día: desde la investigación hasta la operación de servidores.
Tus carpetas locales, primero
Trabaja sobre tus directorios reales. Nada de islas desconectadas.
Un solo flujo de actualización
El mismo para el contenedor y para opencode tradicional.
Ya está todo puesto.
01Python
Python 3 + pip + python3-dev. Venv canónico en <proyecto>/python/: se crea y activa solo. Type checking con pyright, linting con ruff.
02JavaScript
Node.js y npm para scripts, paquetes del ecosistema y soporte de lenguaje vía LSP.
03TypeScript
El mismo toolchain de Node.js más el soporte de TypeScript que opencode activa vía su LSP integrado.
04Rust
Toolchain estable con rustup y objetivo musl para binarios estáticos. Registry, target/ y binarios aislados en <proyecto>/rust/.
Además: git, ssh y gpg; curl, wget y jq para APIs; iptables y Ansible para automatización; y una caja de redes con ping, traceroute, mtr, dig, ss, nmap, tcpdump y tshark.
Agentes que te acompañan.
Se eligen por sesión (en TUI, con Tab) o se invocan por comando.
investigador
Investiga un tema en la web orquestando subagentes en varios idiomas. Entrega un informe en español con fuentes citadas.
arquitecto
Convierte una idea en arquitectura documentada y un plan por hitos. No escribe código: piensa, decide y entrega tareas.
developer
Escribe y refactoriza código limpio, con reglas de calidad siempre activas y skills que se cargan solo cuando la tarea lo pide.
sysadmin
Administra servidores Linux, FreeBSD y macOS con disciplina y guardarraíles. Guarda la memoria de cada cliente en el proyecto.
cyberseguridad
Audita código, infraestructura y agentes de IA. Es el filtro obligatorio antes de aprobar cualquier agente nuevo.
agent-builder
Meta-agente que crea otros agentes: investiga, planifica, construye y audita antes de proponerte el resultado.
Busca en la web orquestando subagentes en varios idiomas y devuelve un informe en español, listo para leer o convertir.
- Dos modos: simplificado (EN/ES) y extendido (EN/FR/ES/DE/ZH/RU).
- Reutiliza búsquedas recientes para no repetir trabajo.
- Informe citado: introducción, cuerpo por temas, discrepancias, conclusión y fuentes.
- Se guarda en documents/investigaciones/ y se convierte con /md2pdf.
Convierte una idea en arquitectura documentada y un plan de trabajo por hitos. No escribe código: piensa, decide y entrega tareas.
- Elicitación socrática de ideas y requisitos.
- Canvas por módulo con contratos (command/query/event) y diagramas C4 en Mermaid.
- ADRs y riesgos; plan maestro con hitos y MoSCoW.
- Handoff a plan y a developer.
Escribe y refactoriza código limpio y mantenible, con reglas de calidad siempre activas.
- DRY inteligente, modularidad progresiva, naming descriptivo, KISS/YAGNI.
- Jerarquía de estilo: custom > PEP 8 > SOTA > Google.
- 7 skills on-demand que se cargan solo cuando la tarea lo pide.
- No incluye reglas de seguridad: eso es rol de cyberseguridad, que audita cada actualización.
Administra servidores Linux, FreeBSD y macOS con disciplina y guardarraíles de seguridad.
- Vendoriza el ruleset heinzel adaptado a opencode.
- Trabaja por SSH o en local, con reglas por distro y procedimiento.
- Memoria 100% por proyecto: un cliente por proyecto en documents/memory/.
- Disambiguación por cliente para no mezclar contextos.
Audita código, infraestructura y agentes de IA. Es el filtro de seguridad obligatorio antes de dar por aprobado cualquier agente nuevo.
- Auditoría de código (OWASP), APIs, dependencias, secretos y criptografía.
- Pentest, recon y OSINT autorizados.
- Respuesta a incidentes, forense, SIEM/SOC y threat hunting.
- Seguridad de IA/LLM: prompt injection y evaluaciones de riesgo.
- Cloud, contenedores, IAM y cumplimiento.
Crea otros agentes: investiga, planifica, construye y audita antes de proponerte el resultado.
- Orquesta investigador → plan → developer → cyberseguridad.
- Regla de Oro: determinístico → guardrails; reutilizable → skills; universal → .md.
- Trabaja efímero en /tmp y requiere decisión humana ante hallazgos medios/altos.
- Alcance global (config del usuario) o local (versionado en el proyecto).
El mismo rigor, reproducible.
investigador
Rastrea repositorios públicos en seis idiomas y reúne las fuentes más adecuadas.
agent-builder
Selecciona fuentes complementarias y vendoriza el agente a partir de ellas.
cyberseguridad
Audita: busca prompt injection y verifica que los permisos sean seguros.
agente listo
Con su procedimiento de actualización documentado, para mantenerse en el tiempo.
Cada agente documenta cómo actualizarse desde sus fuentes originales. Ese trabajo no es de una sola vez: es una pieza que se mantiene.
Capacidades extra, siempre a mano.
frontend-slides
Crea presentaciones HTML autocontenidas y animadas desde cero o convirtiendo un PowerPoint, con descubrimiento visual de estilo anti-"AI slop" y 34 plantillas bold. Exporta a PDF localmente.
/frontend-slides deps en la imagen
mermaid2png
Renderiza diagramas Mermaid a PNG localmente, sin servicios de terceros. Ideal para acompañar la documentación de arquitectura con imágenes listas para publicar.
.mmd → PNG offline
El deploy las lleva a la configuración global de opencode, así que funcionan igual dentro del contenedor y en una instalación tradicional.
Del Markdown al PDF, con estilo.
Los agentes generan Markdown y md2pdf lo convierte a PDF o HTML con estilos agradables para lectura y publicación.
5 estilos
github, pandoc, newsprint, notion y paper.
Tablas inteligentes
Maquetadas según el contenido de cada columna (auto-layout) y con corte de palabras largas.
Comando global
Disponible como /md2pdf, tanto en PDF como en HTML.
En el contenedor, md2pdf y sus estilos ya vienen integrados en la imagen. En opencode tradicional se instalan con --install-tools.
Una identidad propia, separada de la tuya.
Llave SSH
Para usar en servidores remotos sin exponer tu llave personal.
gitconfig
Define el autor de los commits del agente y es personalizable.
Ambas viven en ~/.config/opencode/identity/ y se enlazan dentro del contenedor al iniciar. Así los commits y accesos del agente quedan claramente diferenciados de los tuyos.
Tres mundos, mutuamente excluyentes.
parámetros │ ├── IMAGEN --renew · --rebuild · --update │ ├── GESTIÓN --ps / --ls · --kill / --rm <patrón> │ └── EJECUCIÓN <proyecto> ├── --no-climb no busca .git hacia arriba ├── --tui terminal interactiva └── web (default) servidor web ├── --port <1-65535> default 4096 ├── -config <ruta> datos en otra ubicación └── --network-host comparte la red del host ℹ --help / -h y --version funcionan en cualquier rama
Listo en unos pocos comandos.
git clone <url-del-repo> cd opencode-container chmod +x opencode.sh # acceso cómodo desde cualquier carpeta ln -s "$(pwd)/opencode.sh" ~/.local/bin/ opencode.sh --build # o --renew para actualizarlo # desplegar agentes, skills, estilos y comandos ./src/agents_update.sh # o --check
./opencode.sh /ruta/proyecto # web · 4096 ./opencode.sh /ruta/proyecto --tui # terminal ./opencode.sh /ruta/proyecto --port 4097 ./opencode.sh /ruta/proyecto --password "pwd" ./opencode.sh --ps # activos ./opencode.sh --rebuild # imagen
Requisitos: Podman y Linux o macOS. En el contenedor las herramientas ya vienen integradas; en opencode tradicional se suman con ./src/agents_update.sh --install-tools.
Este launcher no reemplaza a opencode: lo acompaña.
Mismos agentes, comandos, skills y configuración, tanto dentro del contenedor como en una instalación tradicional. Un único script, agents_update.sh, mantiene todo al día en ambos entornos.
opencode.sh by Calisto · v3.7.1 · elaborado a partir del README del proyecto