- Shell 50.5%
- PowerShell 33.3%
- TypeScript 10.9%
- JavaScript 5.3%
opencode-setup
Instalador completo do OpenCode para Windows, Linux e macOS.
Configura OpenCode com provedores, plugins, agentes customizados (38), comandos (8), contextos, skills, swarm de agentes e ferramentas.
Sem download externo de agentes — tudo reside no repositorio.
Funcionalidades
| Componente | Descricao | Win | Linux | Mac |
|---|---|---|---|---|
| Agentes Customizados | 38 agentes + 8 comandos + contextos + skills + tools | ✓ | ✓ | ✓ |
| oh-my-openagent | Team Mode, ultrawork, LSP, background agents (OBRIGATORIO) | ✓ | ✓ | ✓ |
| Swarm Agents | RouteAgent, DiscoveryAgent, CommAgent, SwarmLead, FeedbackLoop | ✓ | ✓ | ✓ |
| OmniRoute | Provider (URL + API key) | ✓ | ✓ | ✓ |
| context-mode | Plugin de memoria entre sessoes | ✓ | ✓ | ✓ |
| opencode-workspace | Orquestracao multi-agente via OCX | ✓ | ✓ | ✓ |
| 8 plugins npm | 4 essenciais + 4 bom-ter | ✓ | ✓ | ✓ |
| OpenCode Web | Servico web (scheduled task / systemd / launchd) | ✓ | ✓ | ✓ |
| Ferramentas remotas | Portal, OpenWork, kimaki, CodeNomad | ✓ | ✓ | ✓ |
Estrutura
opencode-setup/
├── bootstrap.ps1 / bootstrap.sh One-liner install
├── setup.ps1 / setup.sh Entrypoints (CLI)
├── clean.ps1 / clean.sh Remocao completa
├── update.ps1 / update.sh Atualizacao seletiva
├── tui/tui.mjs TUI interativa (Node.js)
│
├── agents/ 38 agentes customizados
├── commands/ 8 comandos
├── contexts/ 8 contextos (standards + workflows)
├── skills/ 7 skills
├── tools/ Tools
│
├── windows/modules/ Scripts Windows
├── linux/modules/ Scripts Linux
├── mac/modules/ Scripts macOS
│
├── config/ Templates de config
└── components/ Manifests (apontam local)
Uso
Preview (dry-run) — nao instala nada
.\setup.ps1 -List
.\setup.ps1 -AllMinimal -List
Instalacao
# Essencial (agentes + oh-my-openagent)
.\setup.ps1 -AllMinimal
# Tudo
.\setup.ps1 -All
# Selecionar manualmente
.\setup.ps1 -WithAgents -WithOhMyOpenCode -WithOmniRoute
Linux/Mac
./setup.sh --list
./setup.sh --all-minimal
./setup.sh --all
TUI (Node.js)
cd tui
npm install # so na primeira vez
node tui.mjs
Modos: Instalacao completa | Essencial | Selecionar manualmente | Dry-run
One-liner (bootstrap)
# Default: TUI interativa (checkboxes bonitos, preview, dry-run)
irm https://codeberg.org/andeerc/opencode-setup/raw/branch/main/bootstrap.ps1 | iex
# CLI mode (sem Node ou se preferir terminal basico)
irm ... | iex -Args "-NoTui"
# Com flags (PS 7+)
irm ... | iex -Args "-All"
# Com flags (PS 5.1): salva e executa
irm ... -OutFile "$env:TEMP\b.ps1"; & "$env:TEMP\b.ps1" -All
# Bash (Linux/Mac)
bash -c "$(curl -fsSL https://codeberg.org/andeerc/opencode-setup/raw/branch/main/bootstrap.sh)"
Cleanup — remove instalacao
# Windows
.\clean.ps1 -All
# Preview do que sera removido
.\clean.ps1 -All -WhatIf
# Seletivo
.\clean.ps1 -Agents -Plugins
# Linux/Mac
./clean.sh --all
# Preview
./clean.sh --all --dry-run
# One-liner (baixa e executa)
irm https://codeberg.org/andeerc/opencode-setup/raw/branch/main/clean.ps1 | iex
bash -c "$(curl -fsSL https://codeberg.org/andeerc/opencode-setup/raw/branch/main/clean.sh)"
Update — atualiza componentes
# Windows
.\update.ps1
# Dry-run (mostra o que vai fazer)
.\update.ps1 -DryRun
# Linux/Mac
./update.sh
# Dry-run
./update.sh --dry-run
O update nao reinstala tudo — atualiza apenas agentes, skills e manifests para a versao mais recente do repositorio, preservando config e plugins.
Flags
| Flag | Descricao |
|---|---|
-All / --all |
Instala tudo |
-AllMinimal / --all-minimal |
Essenciais: agentes + oh-my-openagent |
-WithAgents / --with-agents |
Agentes customizados (38 agentes + 8 comandos + skills) |
-WithOhMyOpenCode / --with-oh-my-openagent |
oh-my-openagent (OBRIGATORIO) |
-WithOmniRoute / --with-omni |
Provider OmniRoute |
-WithContextMode / --with-ctx |
Plugin de memoria entre sessoes |
-WithWorkspace / --with-workspace |
Orquestracao multi-agente |
-WithWeb / --with-web |
OpenCode Web como servico |
-WithExtras / --with-extras |
Plugins extras |
-List / --list |
Preview sem instalar (dry-run) |
-NonInteractive / --non-interactive |
Modo silencioso |
-Help / --help |
Mostra ajuda |
Componentes
Agentes (38)
| Categoria | Agentes |
|---|---|
| Core | openagent, opencoder |
| Meta | system-builder, repo-manager |
| Content | technical-writer, copywriter |
| Data | data-analyst |
| Subagentes Core (8) | TaskManager, ContextScout, ExternalScout, BatchExecutor, StageOrchestrator, ContextManager, ContextRetriever, DocWriter |
| Subagentes Code (4) | CoderAgent, TestEngineer, CodeReviewer, BuildAgent |
| Subagentes Planning (5) | ArchitectureAnalyzer, PrioritizationEngine, StoryMapper, ADRManager, ContractManager |
| Subagentes Swarm (5) | RouteAgent, DiscoveryAgent, CommAgent, SwarmLead, FeedbackLoop |
| Extras (4) | FrontendSpecialist, DevOpsSpecialist, ImageSpecialist, SimpleResponder |
Plugins (8)
| Plugin | Tipo |
|---|---|
| omniroute-auth | ESSENCIAL |
| shell-strategy | ESSENCIAL |
| vibeguard | ESSENCIAL |
| websearch-cited | ESSENCIAL |
| skillful | BOM TER |
| dcp | BOM TER |
| goal-plugin | BOM TER |
| supermemory | BOM TER |
Removeu 6 redundantes: notify, firecrawl, conductor, worktree, scheduler, canvas.
Scripts
Todos os 3 SOs copiam arquivos locais (cp) — sem download externo.
Tudo auto-contido no repositorio.
| Script | Antes | Agora |
|---|---|---|
Install-Agents.ps1 |
Baixava via Invoke-WebRequest |
Copia local com Copy-Item |
install-agents.sh (linux/mac) |
Baixava via curl |
Copia local com cp |
setup.ps1 |
530 linhas, sem preview | ~270 linhas, -List, -AllMinimal |
setup.sh |
480 linhas | --list, --all-minimal |
bootstrap.ps1 |
Parse manual $args |
param() block |
TUI (Node.js)
node tui/tui.mjs
- Usa
@inquirer/prompts— checkboxes, selecao, confirmacao - Zero build —
npm install+node tui.mjs - Modos: all, minimal, custom, dry-run
- Auto-instala deps se faltar
Contribuindo
PRs sao bem-vindas em https://codeberg.org/andeerc/opencode-setup
Mude apenas os arquivos em agents/, commands/, contexts/, skills/ ou tools/.
Nao edite oac-*.json diretamente sem atualizar os manifests correspondentes.