Skip to content

Latest commit

 

History

History
285 lines (205 loc) · 10.5 KB

README.md

File metadata and controls

285 lines (205 loc) · 10.5 KB

opencode-suites-installer

OCS (OpenCode Config Suites) quick installer for Multi Agents workflow, AI coding profile setup, and cross-platform OpenCode onboarding (Windows, Linux, macOS).

Quick Install

Beta rollout branch (beta)

Use this branch for beta rollout and validation before broad release.

This branch currently includes installer hardening for WSL/macOS/Windows edge cases:

  • automatic dependency install/retry when runtime prerequisites are missing
  • clearer staged runtime messages, retries, and health checks for long-running install/build steps
  • stronger opencode auth login stability via plugin integrity checks + rebuild fallback
  • safer command resolution for ocs and opencode without semantic alias regressions
  • helper scripts for environment reset (uninstall.sh) and state safety (backup.sh / restore.sh)

macOS / Linux / WSL

curl -fsSL https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/beta/install.sh | bash

Install specific version:

curl -fsSL https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/beta/install.sh | bash -s -- --version 2.1.12

WSL note: run the command inside WSL terminal (bash/zsh), not from Windows PowerShell.

Windows (PowerShell 7)

pwsh -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/beta/install.ps1 | iex"

Install specific version:

pwsh -NoProfile -ExecutionPolicy Bypass -Command '$env:OCS_VERSION = "2.1.12"; irm https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/beta/install.ps1 | iex'

Windows note: run via pwsh (PowerShell 7), not powershell.exe (Windows PowerShell 5.1), to avoid parser errors like Unexpected token '??'.

Stable branch (main)

macOS / Linux / WSL

curl -fsSL https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/main/install.sh | bash

Windows (PowerShell 7)

pwsh -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/main/install.ps1 | iex"

Run installer from your normal user shell. Do not wrap installer command in sudo, or profile/config writes may target the wrong home directory.

Quick Start (Latest Beta Stabilization)

If you want deterministic behavior while this beta branch is still collecting edge-case reports, use pinned version + branch:

macOS / Linux / WSL

curl -fsSL https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/beta/install.sh | bash -s -- --version 2.1.12 --branch beta

Windows (PowerShell 7)

pwsh -NoProfile -ExecutionPolicy Bypass -Command '$env:OCS_VERSION = "2.1.12"; $env:OCS_RELEASE_BRANCH = "beta"; irm https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/beta/install.ps1 | iex'

Post-install smoke checks:

opencode --help
opencode auth login --help
opencode web --help
ocs setup:profile --help

EXA API Onboarding (Windows/WSL/Linux/macOS parity)

Use the exact same EXA account flow on every platform:

  1. Sign in or create account: https://dashboard.exa.ai
  2. Open API key page: https://dashboard.exa.ai/api-keys
  3. Create an API key and copy it once (store securely; dashboard will not always show it again).

Then wire and verify in terminal:

  • macOS / Linux / WSL: 
    ocs exa setup --api-key <YOUR_EXA_API_KEY>
ocs exa check
  • Windows PowerShell 7: 
    ocs exa setup --api-key <YOUR_EXA_API_KEY>
ocs exa check
    If PowerShell policy blocks script shims, use ocs.cmd fallback.

To keep GitHub MCP green on all platforms:

  • Authenticate once: gh auth login
  • Export token for MCP config:
    • macOS / Linux / WSL: export GITHUB_PERSONAL_ACCESS_TOKEN="$(gh auth token)"
    • Windows PowerShell: $env:GITHUB_PERSONAL_ACCESS_TOKEN = gh auth token
  • Verify MCP health: opencode mcp list

Codex Setup Profiles

  • codex-5.3-token-saver
    • Primary model: openai/gpt-5.3-codex
    • Token-efficient worker lane: openai/gpt-5.1-codex-mini
    • Recommended default for most users: strongest balance for planning -> execution flow, efficient token usage, and stable precision once your workflow is already tidy.
    • Best for: daily coding sessions where you want high throughput without sacrificing decision quality.
  • codex-5.4-best-perform
    • Primary model: openai/gpt-5.4
    • Fast lane: openai/gpt-5.3-codex
    • Best for: maximum-depth architecture reviews and the toughest debugging cases.
  • codex-5.4-token-saver
    • Primary model: openai/gpt-5.4
    • Token-efficient worker lane: openai/gpt-5.1-codex-mini
    • Best for: teams that want GPT-5.4 orchestration with tighter token control.

Notes:

  • These three setups are selectable from ocs setup:profile.
  • Model availability still follows your runtime account entitlements (opencode models openai).

Troubleshooting Commands

  • Diagnose PATH/shim issues: 
    ocs doctor
  • If ocs or opencode is not detected on macOS/Linux: 
    export PATH="$HOME/.opencode/bin:$HOME/.local/bin:$HOME/.bun/bin:$PATH"
hash -r
ocs doctor
  • If ocs or opencode is not detected on Windows PowerShell: 
    Get-Command ocs
Get-Command opencode
ocs doctor

Uninstall otomatis (Linux/macOS/WSL)

Kalau mau reset total environment sebelum retest, jalankan script uninstall.sh dari root repo:

bash ./uninstall.sh --yes

Catatan penting:

  • Default auto backup aktif sebelum data dihapus.
  • Untuk matikan backup: ./uninstall.sh --yes --no-backup
  • Untuk set lokasi backup: ./uninstall.sh --yes --backup-dir /path/backup
  • Untuk simulasi aman tanpa perubahan: ./uninstall.sh --dry-run --yes --no-backup

Backup / Restore cepat (Linux/macOS/WSL)

Kalau mau simpan lalu pulihkan state sebelum/selesai retest:

bash ./backup.sh --yes
bash ./restore.sh --yes

Opsional aman:

  • Preview backup tanpa menulis apa pun: bash ./backup.sh --dry-run
  • Preview restore tanpa ekstrak: bash ./restore.sh --dry-run
  • Pilih archive tertentu saat restore: bash ./restore.sh --archive /path/file.tar.gz --yes

macOS: opencode auth login fallback ke API key

Kalau di macOS login malah minta API key (padahal harusnya keluar OAuth Antigravity), jalankan langkah ini dari Terminal biasa:

  1. Pastikan binary yang kepanggil urutannya benar:
which -a opencode
PATH="$HOME/.opencode/bin:$HOME/.local/bin:$HOME/.bun/bin:$PATH" opencode --version
  1. Pastikan plugin OAuth Antigravity terpasang (cek salah satu entry valid):
ls -la ~/.config/opencode/plugins/opencode-multi-auth/dist/src/plugin.js
ls -la ~/.config/opencode/plugins/opencode-multi-auth/dist/index.js
grep -n "OAuth with Google (Antigravity)" ~/.config/opencode/plugins/opencode-multi-auth/dist/src/plugin.js || grep -n "OAuth with Google (Antigravity)" ~/.config/opencode/plugins/opencode-multi-auth/dist/index.js
grep -n "opencode-multi-auth" ~/.config/opencode/opencode.json

Jika dist/src/plugin.js dan dist/index.js sama-sama belum ada, jalankan repair cepat ini:

cd ~/.config/opencode/plugins/opencode-multi-auth || exit 1
bun install --frozen-lockfile || bun install
PATH="$HOME/.opencode/bin:$HOME/.local/bin:$HOME/.bun/bin:$PATH" bun run build || npm run build
OCS_SETUP_INSTALLER_MODE=1 bun scripts/setup.js --headless --profile codex-5.3-token-saver --mode low
ls -la ~/.config/opencode/plugins/opencode-multi-auth/dist/src/plugin.js ~/.config/opencode/plugins/opencode-multi-auth/dist/index.js

Kalau folder plugin belum ada sama sekali, rerun installer:

curl -fsSL https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/beta/install.sh | bash -s -- --version 2.1.12
  1. Paksa login via provider Antigravity dengan PATH prioritas:
PATH="$HOME/.opencode/bin:$HOME/.local/bin:$HOME/.bun/bin:$PATH" opencode auth login --provider antigravity
  1. Kalau masih fallback ke API key, jalankan debug:
OPENCODE_LOG_LEVEL=debug PATH="$HOME/.opencode/bin:$HOME/.local/bin:$HOME/.bun/bin:$PATH" opencode auth login --provider antigravity

Catatan: jalankan perintah di shell Terminal normal (bukan embedded TUI) supaya picker OAuth tidak bentrok.

Windows: PowerShell 7 requirement

  • Verify PowerShell 7: 
    pwsh --version
pwsh -NoProfile -Command "$PSVersionTable.PSVersion"
  • Install PowerShell 7 on Windows:
  • If terminal still opens 5.1, force full path: 
    & "$env:ProgramFiles\PowerShell\7\pwsh.exe" -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/main/install.ps1 | iex"

Buat yang Nggak Ada Waktu Ngoprek

Kalau kamu sudah lama ngikutin OpenCode tapi masih bingung setup agent, atau baru mulai dan belum kebayang harus start dari mana, OCS disiapkan buat jalur cepat.

  • Tinggal install, add akun, pilih profile, dan pakai.
  • Tidak perlu trial and error config dari nol.
  • Siap untuk workflow multi-agent harian dengan setup yang lebih rapi.

OCS v2.1.12 Private Rollout - Yang Sudah Solid

Kalau kamu ngoding pakai AI setiap hari, biasanya yang bikin seret itu kuota cepat habis, workflow single-agent lama, dan pindah tool bikin fokus buyar. OCS dirancang untuk ngatasin problem itu dari awal.

  • Multi-agent teamwork dengan 14 agent role-specific (debug, riset docs, review, security audit, eksekusi).
  • 11 profile siap pilih (termasuk jalur GPT-5.4 quality-first, GPT-5.4 token-saver, dan Codex 5.3 token-saver).
  • Multi-account workflow untuk jalur penggunaan harian.
  • LSP + MCP aktif untuk docs lookup dan GitHub code search real-time.
  • Hardening installer Linux/WSL/Windows, termasuk stabilisasi ocs shim dan deteksi command opencode.
  • Jalur login Antigravity OAuth dipulihkan dan tervalidasi di opencode auth login.

Nggak pake lama!

Install OCS sekarang:

Channel Mapping

  • Buyer private source repo: andyvandaric/andyvand-opencode-config
  • Default source branch: beta
  • Bundle source path: assets/opencode-config-suites-v*.tar.gz

Access Behavior

  • If your GitHub account has beta access, installer pulls bundle from buyer beta channel.
  • If access is missing, installer redirects to WhatsApp purchase CTA.