omo-suites 1.5.0

package/docs/agents.md

@@ -0,0 +1,61 @@
+# Agents
+
+OMO Suites includes **15 specialized agents** that handle **32 task categories**. Each agent has a tuned model, thinking budget, and system prompt.
+
+## Agent Roster
+
+| Agent | Emoji | Model | Budget | Specialization |
+|-------|-------|-------|--------|----------------|
+| **Sisyphus** | 🔨 | Claude Opus 4.6 | 16K | Implementation, code writing |
+| **Atlas** | 🗺️ | Claude Opus 4.6 | 20K | Task orchestration, delegation |
+| **Prometheus** | 🔥 | Claude Opus 4.6 | 40K | Planning, requirements |
+| **Metis** | 🧠 | Claude Opus 4.6 | 32K | Gap analysis, edge cases |
+| **Momus** | 👁️ | GPT-5.3 Codex | 40K | Code review, quality |
+| **Oracle** | 🔮 | GPT-5.3 Codex | 32K | Architecture decisions |
+| **Hephaestus** | ⚒️ | GPT-5.3 Codex | 50K | Deep refactoring |
+| **Librarian** | 📚 | Claude Sonnet 4.6 | 8K | Search, documentation |
+| **Explore** | 🧭 | Claude Sonnet 4.6 | 10K | Codebase discovery |
+| **Multimodal Looker** | 👀 | Claude Sonnet 4.6 | 15K | Visual analysis |
+| **Frontend UI/UX** | 🎨 | Gemini 3.1 Pro | 20K | UI/UX, accessibility |
+| **Architect** | 🏗️ | Claude Opus 4.6 | 40K | System design |
+| **Database Expert** | 🗃️ | Claude Opus 4.6 | 32K | Queries, migrations |
+| **DevRel** | 🚀 | Kimi K2.5 | 20K | Docs, writing |
+| **Image Generator** | 🖼️ | GLM Image | — | Image generation |
+
+## Category Routing
+
+Each task category automatically routes to the best agent:
+
+| Categories | Agent |
+|-----------|-------|
+| `deep`, `ultrabrain`, `deep-reasoning` | Sisyphus |
+| `backend`, `debugging`, `refactor`, `testing`, `deployment`, `migration` | Sisyphus |
+| `visual-engineering`, `artistry`, `accessibility`, `i18n`, `seo`, `develop-web-game` | Frontend UI/UX |
+| `code-review`, `spec-review` | Momus |
+| `api-design`, `architect` | Architect |
+| `database` | Database Expert |
+| `brainstorming`, `business-analysis` | Oracle |
+| `writing`, `research` | DevRel |
+| `security`, `performance` | Hephaestus |
+| `token-efficiency`, `introspection` | Metis |
+| `quick`, `unspecified-low` | Librarian |
+| `image-generation` | Image Generator |
+
+## Usage
+
+```bash
+# List all agents
+omocs agent list
+
+# Switch active agent
+omocs agent use momus
+
+# Get agent details + system prompt
+omocs agent info atlas
+
+# List all 32 task categories
+omocs agent categories
+
+# Route a task to the best agent
+omocs agent route debugging
+```

package/docs/cli.md

@@ -0,0 +1,85 @@
+# CLI Reference
+
+Full command reference for OMO Suites standalone CLI.
+
+## Setup
+
+```bash
+omocs init              # Interactive setup wizard
+omocs doctor            # Check if everything works
+```
+
+## Account Management
+
+```bash
+omocs account add       # Add API key (encrypted storage)
+omocs account list      # Show all accounts + status
+omocs account rotate    # Switch to next available key
+omocs account check     # Verify key health
+```
+
+## Profiles
+
+```bash
+omocs profile list      # Show all 13 profiles
+omocs profile use <name>  # Switch profile
+omocs profile create    # Build a custom profile
+omocs profile export    # Share profile as JSON
+```
+
+See [profiles.md](profiles.md) for the full list of available profiles.
+
+## Agents
+
+```bash
+omocs agent list        # Show 15 agent roles
+omocs agent use <name>  # Switch active agent
+omocs agent info <name> # Agent details + system prompt
+omocs agent categories  # List all 32 task categories
+omocs agent route <cat> # Which agent handles this category?
+```
+
+See [agents.md](agents.md) for the full agent roster and routing table.
+
+## LSP
+
+```bash
+omocs lsp detect        # Scan project, suggest LSP servers
+omocs lsp install       # Install detected LSP servers
+```
+
+See [lsp.md](lsp.md) for all supported LSP configurations.
+
+## MCP
+
+```bash
+omocs mcp list          # Available MCP tools
+omocs mcp install <srv> # Install + auto-configure
+```
+
+See [mcp.md](mcp.md) for all available MCP servers.
+
+## Stats
+
+```bash
+omocs stats             # Token usage summary
+```
+
+## Config
+
+### Config directory
+
+```
+~/.omocs/
+├── config.json      # Accounts, preferences (encrypted keys)
+├── profiles/        # Custom profile definitions
+├── agents/          # Custom agent role overrides
+└── stats.json       # Token usage data
+```
+
+### Config files touched
+
+- `oh-my-opencode.json` — Agent and category model overrides
+- `.opencode.json` / `opencode.json` — OpenCode main config (agents, MCP, LSP)
+
+Both files are backed up before modification.

package/docs/installation.md

@@ -0,0 +1,305 @@
+# Installation
+
+## For Humans
+
+### Option 1: Install via npm (Recommended)
+
+```bash
+npm install -g omo-suites
+```
+
+This gives you the `omocs` CLI command globally. Requires Node.js >= 18.
+
+Then run the setup wizard:
+```bash
+omocs init
+```
+
+### Option 2: Install via Bun
+
+```bash
+bun add -g omo-suites
+```
+
+### Option 3: Install from source
+
+Paste this into your LLM agent session:
+
+```
+Install and configure OMO Suites by following the instructions here:
+https://raw.githubusercontent.com/TheFahmi/omo-suites-installer/main/docs/installation.md
+```
+
+**Alternative, Not recommended, do this by yourself**
+
+```bash
+# One-liner (bash/zsh)
+curl -fsSL https://raw.githubusercontent.com/TheFahmi/omo-suites-installer/main/install.sh | bash
+
+# Or manually
+git clone https://github.com/TheFahmi/omo-suites-installer.git ~/.omocs
+cd ~/.omocs && bun install && bun run build
+
+# Then run the setup wizard (recommended — handles everything)
+omocs init
+```
+
+> **Note**: Source install requires [Bun](https://bun.sh) runtime. The installer handles that if you don't have it.
+>
+> **New in v1.5.0**: `omocs init` is now the recommended setup method. It auto-installs oh-my-opencode, registers plugins to `opencode.json`, and optionally sets up Launchboard — all in one command.
+
+## For LLM Agents
+
+> **IMPORTANT: Use `curl` to fetch this file, NOT WebFetch.** WebFetch summarizes content and loses critical details. Always use:
+>
+> ```bash
+> curl -fsSL https://raw.githubusercontent.com/TheFahmi/omo-suites-installer/main/docs/installation.md
+> ```
+
+If you're an LLM Agent helping set up OMO Suites — welcome! You're about to install the most complete open-source config toolkit for OpenCode. Follow these steps:
+
+### Step 0: Ask user about their setup
+
+Ask the user these questions:
+
+1. **Which AI providers do you have?**
+   - Claude (Anthropic) — Pro/Max subscription or API key?
+   - OpenAI/ChatGPT — Plus subscription or API key?
+   - Google Gemini — API access?
+   - Kimi — subscription?
+   - GitHub Copilot — subscription?
+   - Ollama/local models — installed?
+
+2. **Do you have oh-my-opencode installed?**
+   - If **yes** → `omocs init` will detect it automatically
+   - If **no** → `omocs init` will install it for you
+
+3. **What's your priority?**
+   - Maximum quality (use best models)
+   - Balanced cost/quality
+   - Minimum cost
+   - Fully free/local
+
+### Step 1: Install Bun (if not installed)
+
+```bash
+if command -v bun &> /dev/null; then
+    echo "Bun $(bun --version) is installed"
+else
+    echo "Installing Bun..."
+    curl -fsSL https://bun.sh/install | bash
+fi
+```
+
+### Step 2: Install OpenCode (if not installed)
+
+```bash
+if command -v opencode &> /dev/null; then
+    echo "OpenCode $(opencode --version) is installed"
+else
+    echo "OpenCode is not installed. Please install it first."
+    echo "Ref: https://opencode.ai/docs"
+fi
+```
+
+### Step 3: Clone and install OMO Suites
+
+```bash
+git clone https://github.com/TheFahmi/omo-suites-installer.git ~/.omocs
+cd ~/.omocs
+bun install
+bun run build
+```
+
+### Step 4: Run `omocs init` (Recommended — One Command Setup)
+
+```bash
+omocs init
+```
+
+**`omocs init` handles everything automatically:**
+- ✅ Checks OpenCode installation
+- ✅ Installs oh-my-opencode (if not already installed)
+- ✅ Registers both `oh-my-opencode` and `omocs` as plugins in `opencode.json`
+- ✅ Optionally sets up Launchboard (AI Kanban board)
+- ✅ Sets master password for API key encryption
+- ✅ Configures API providers and keys
+- ✅ Selects and applies a profile
+- ✅ Detects project stack and suggests LSP servers
+- ✅ Configures MCP tools
+
+The wizard is interactive and guides you through each step. **This is the recommended setup method** — no need to manually edit `opencode.json` or install oh-my-opencode separately.
+
+> **For non-interactive / CI environments**, see the [Manual Setup](#manual-setup-advanced) section below.
+
+### Step 5: Choose a profile
+
+`omocs init` will prompt you to choose a profile during setup. If you want to change it later, use:
+
+Based on user's providers, recommend a profile:
+
+| User Has | Recommended Profile |
+|----------|-------------------|
+| Claude + OpenAI + Gemini | `ultra-mixed` |
+| Claude only (Pro/Max) | `opus-4.6-all` or `opus-4.6-lead` |
+| Claude only (Sonnet) | `sonnet-4.6-all` |
+| OpenAI only | `codex-5.3-all` |
+| OpenAI + Gemini | `codex-5.3-gemini` |
+| OpenAI + Claude | `codex-5.3-sonnet` |
+| Gemini only | `gemini-3-all` |
+| Kimi only | `kimi-k2.5-all` |
+| Budget-conscious | `budget-mixed` |
+| No API keys / Ollama | `local-free` |
+
+Apply profile via CLI:
+```bash
+omocs profile use <profile-name>
+```
+
+Or via plugin tool (inside OpenCode session):
+```
+Use omocs_profile_switch to switch to ultra-mixed profile
+```
+
+### Step 6: Verify setup
+
+```bash
+omocs doctor
+```
+
+This runs a 10-point health check:
+- ✅ Bun runtime
+- ✅ OpenCode installed
+- ✅ Plugin registered
+- ✅ oh-my-opencode.json valid
+- ✅ opencode.json valid
+- ✅ Profile applied
+- ✅ Agent configs valid
+- ✅ MCP servers configured
+- ✅ LSP servers detected
+- ✅ API key(s) accessible
+
+### Step 7: Start using it
+
+**CLI mode:**
+```bash
+omocs profile list     # See all 13 profiles
+omocs agent list       # See all 15 agents
+omocs mcp list         # See 11 MCP servers
+omocs agent route debugging  # Which agent handles this?
+```
+
+**Plugin mode (inside OpenCode):**
+Agents automatically have access to `omocs_*` tools. Try:
+- "Switch to ultra-mixed profile"
+- "Which agent should handle this frontend task?"
+- "Install the context7 MCP server"
+- "Run a health check"
+
+---
+
+## Manual Setup (Advanced)
+
+If you prefer to set things up manually (or are in a non-interactive environment), you can skip `omocs init` and do these steps yourself:
+
+### Install oh-my-opencode
+
+```bash
+npm install -g oh-my-opencode
+# or
+bun add -g oh-my-opencode
+```
+
+### Register plugins in opencode.json
+
+Add OMO Suites and oh-my-opencode to your `opencode.json` (usually at `~/.config/opencode/opencode.json`):
+
+```jsonc
+{
+  // ... existing config ...
+  "plugin": [
+    "oh-my-opencode",  // if you have it
+    "~/.omocs"         // OMO Suites
+  ]
+}
+```
+
+Or if using npm-style plugins:
+```jsonc
+{
+  "plugins": {
+    "omocs": {
+      "source": "local:~/.omocs"
+    }
+  }
+}
+```
+
+### Setup Launchboard (optional)
+
+```bash
+omocs launchboard setup
+omocs launchboard start
+```
+
+---
+
+## Available Profiles
+
+### 🌐 All Scope — Every agent uses same model family
+| Profile | Model | Use Case |
+|---------|-------|----------|
+| `opus-4.6-all` | Claude Opus 4.6 | Maximum quality |
+| `codex-5.3-all` | GPT-5.3 Codex | OpenAI ecosystem |
+| `gemini-3-all` | Gemini 3.1 Pro + Flash | Google ecosystem |
+| `sonnet-4.6-all` | Claude Sonnet 4.6 | Balanced cost/quality |
+| `kimi-k2.5-all` | Kimi K2.5 | Ultra cheap, Claude-like |
+
+### 👑 Lead Scope — Premium for leads, cheaper for workers
+| Profile | Lead | Workers | Use Case |
+|---------|------|---------|----------|
+| `opus-4.6-lead` | Opus 4.6 | Sonnet + Gemini + Codex | Premium orchestration |
+| `sonnet-4.6-lead` | Sonnet 4.6 | Gemini + Flash | Mid-cost lead |
+
+### 🔀 Mixed Scope — Best model per role
+| Profile | Models | Use Case |
+|---------|--------|----------|
+| `codex-5.3-hybrid` | Codex + Gemini + Flash + Sonnet | Multi-provider |
+| `codex-5.3-gemini` | Codex + Gemini Pro + Flash | OpenAI + Google |
+| `codex-5.3-sonnet` | Codex + Sonnet 4.6 | OpenAI + Anthropic |
+| `ultra-mixed` | Opus + Codex + Gemini + Sonnet + Kimi | **Best per task** |
+
+### 💰 Economy Scope — Cheapest viable
+| Profile | Models | Use Case |
+|---------|--------|----------|
+| `budget-mixed` | Sonnet + Flash + Kimi | Minimal cost |
+| `local-free` | Ollama DeepSeek Coder v3 | Zero cost, offline |
+
+---
+
+## Troubleshooting
+
+**Plugin not loading?**
+- Check `opencode.json` has OMO Suites in `plugin` array
+- Run `omocs doctor` for diagnostics
+- Check OpenCode version (requires 1.0.150+)
+
+**Profile switch not working?**
+- Verify `oh-my-opencode.json` exists at `~/.config/opencode/oh-my-opencode.json`
+- Check file permissions
+- Run `omocs config get` to see current state
+
+**Tools not appearing in OpenCode?**
+- Restart OpenCode after adding plugin
+- Check plugin build: `cd ~/.omocs && bun run build`
+- Verify `dist/plugin.js` exists
+
+---
+
+## Uninstall
+
+```bash
+# Remove plugin from opencode.json (edit manually)
+# Remove installation
+rm -rf ~/.omocs
+```

package/docs/lsp.md

@@ -0,0 +1,34 @@
+# LSP Configurations
+
+OMO Suites includes **10 LSP (Language Server Protocol) configurations** with auto-detection based on your project's files.
+
+## Available LSP Servers
+
+| LSP | Detects | Install Command |
+|-----|---------|-----------------|
+| **TypeScript** | `tsconfig.json`, `package.json` | `npm i -g typescript-language-server typescript` |
+| **Tailwind CSS** | `tailwind.config.*` | `npm i -g @tailwindcss/language-server` |
+| **ESLint** | `.eslintrc*`, `eslint.config.js` | `npm i -g vscode-langservers-extracted` |
+| **CSS** | `*.css`, `*.scss` | `npm i -g vscode-langservers-extracted` |
+| **HTML** | `*.html` | `npm i -g vscode-langservers-extracted` |
+| **JSON** | `*.json` | `npm i -g vscode-langservers-extracted` |
+| **YAML** | `*.yml`, `*.yaml` | `npm i -g yaml-language-server` |
+| **Prisma** | `schema.prisma` | `npm i -g @prisma/language-server` |
+| **SQL** | `*.sql` | `npm i -g sql-language-server` |
+| **Markdown** | `*.md` | `brew install marksman` |
+
+## Usage
+
+```bash
+# Scan project and detect needed LSP servers
+omocs lsp detect
+
+# Install all detected LSP servers
+omocs lsp install
+```
+
+## How Detection Works
+
+When you run `omocs lsp detect`, it scans your project directory for configuration files and file extensions that indicate which languages/tools you're using. It then suggests the appropriate LSP servers to install.
+
+Detection is automatic — just run it in your project root.

package/docs/mcp.md

@@ -0,0 +1,42 @@
+# MCP Servers
+
+OMO Suites includes a registry of **11 MCP (Model Context Protocol) servers** with one-click install and auto-configuration.
+
+## Available Servers
+
+| Server | Description | Env Vars |
+|--------|-------------|----------|
+| **postgres** | PostgreSQL database access | `POSTGRES_CONNECTION_STRING` |
+| **fetch** | HTTP fetch for web content | — |
+| **filesystem** | File system operations | — |
+| **brave-search** | Web search via Brave | `BRAVE_API_KEY` |
+| **slack** | Slack workspace integration | `SLACK_BOT_TOKEN` |
+| **redis** | Redis cache/store access | `REDIS_URL` |
+| **docker** | Docker container management | — |
+| **sentry** | Error tracking via Sentry | `SENTRY_AUTH_TOKEN` |
+| **context7** | Library documentation search | — |
+| **grep-app** | Code search via grep.app | — |
+| **exa-websearch** | AI-powered web search | `EXA_API_KEY` |
+
+## Usage
+
+```bash
+# List available MCP servers
+omocs mcp list
+
+# Install + auto-configure a server
+omocs mcp install ctx7
+omocs mcp install postgres
+omocs mcp install brave-search
+```
+
+## How It Works
+
+When you install an MCP server, OMO Suites:
+
+1. Adds the server configuration to your `opencode.json`
+2. Sets up required environment variables (prompts for values)
+3. Installs the npm package if needed
+4. Backs up your config before any changes
+
+Servers that require API keys will prompt you during installation. You can also set environment variables beforehand.

package/docs/plugin.md

@@ -0,0 +1,69 @@
+# Plugin Mode
+
+When loaded as an OpenCode plugin, OMO Suites gives your agents **12 tools** they can call directly.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `omocs_profile_list` | List all 13 profiles with models and scope types |
+| `omocs_profile_switch` | Switch profile — updates agents, categories, configs |
+| `omocs_agent_list` | List all 15 agents with models and thinking budgets |
+| `omocs_agent_info` | Get detailed agent info (model, budget, tools, tags) |
+| `omocs_agent_route` | Route a task category to the best agent |
+| `omocs_categories` | List all 32 task categories and routing |
+| `omocs_mcp_list` | List 11 available MCP servers |
+| `omocs_mcp_install` | Install + auto-configure an MCP server |
+| `omocs_lsp_detect` | Scan project and suggest LSP servers |
+| `omocs_doctor` | Run comprehensive health check |
+| `omocs_account_status` | Check API key status and provider health |
+| `omocs_config_get` | View current configuration |
+
+## Setup
+
+Add to your `opencode.json`:
+
+```json
+{
+  "plugins": {
+    "omocs": {
+      "source": "npm:omocs"
+    }
+  }
+}
+```
+
+Or from a local clone:
+
+```json
+{
+  "plugins": {
+    "omocs": {
+      "source": "local:/path/to/omocs"
+    }
+  }
+}
+```
+
+## How Agents Use It
+
+Agents automatically know about these tools via **system prompt injection**. When the plugin loads, it injects instructions into the agent's system prompt so they know:
+
+- What tools are available
+- When to use each tool
+- How to interpret results
+
+This means agents can proactively use OMO Suites tools without being explicitly told — they'll route tasks, switch profiles, and install MCP servers as needed.
+
+## Example Agent Interactions
+
+```
+Agent: "Let me check which profile is active..."
+→ calls omocs_profile_list
+
+Agent: "This is a frontend task, let me route it..."
+→ calls omocs_agent_route with category "visual-engineering"
+
+Agent: "I need database access for this query..."
+→ calls omocs_mcp_install with server "postgres"
+```

package/docs/profiles.md

@@ -0,0 +1,52 @@
+# Profiles
+
+OMO Suites ships with **13 profiles** across 4 scope types. Each profile defines which AI model every agent uses.
+
+## 🌐 All Scope — Every agent uses same model
+
+| Profile | Model | Best For |
+|---------|-------|----------|
+| **opus-4.6-all** | Claude Opus 4.6 | Maximum quality, complex tasks |
+| **codex-5.3-all** | GPT-5.3 Codex | OpenAI-focused workflows |
+| **gemini-3-all** | Gemini 3.1 Pro + Flash | Google ecosystem, large context |
+| **sonnet-4.6-all** | Claude Sonnet 4.6 | Balanced cost/quality |
+| **kimi-k2.5-all** | Kimi K2.5 | Ultra cheap, Claude-like |
+
+## 👑 Lead Scope — Primary for leaders, cheaper for workers
+
+| Profile | Lead Model | Worker Model | Best For |
+|---------|------------|--------------|----------|
+| **opus-4.6-lead** | Opus 4.6 | Sonnet + Gemini + Codex | Premium lead, budget workers |
+| **sonnet-4.6-lead** | Sonnet 4.6 | Gemini + Flash | Mid-cost lead + cheap workers |
+
+## 🔀 Mixed Scope — Best model per role
+
+| Profile | Models | Best For |
+|---------|--------|----------|
+| **codex-5.3-hybrid** | Codex + Gemini + Flash + Sonnet | Multi-provider diversity |
+| **codex-5.3-gemini** | Codex + Gemini Pro + Flash | OpenAI + Google duo |
+| **codex-5.3-sonnet** | Codex + Sonnet 4.6 | OpenAI + Anthropic duo |
+| **ultra-mixed** | Opus + Codex + Gemini + Sonnet + Kimi | **Best possible per task** |
+
+## 💰 Economy Scope — Cheapest viable models
+
+| Profile | Models | Best For |
+|---------|--------|----------|
+| **budget-mixed** | Sonnet + Flash + Kimi | Minimal cost, still functional |
+| **local-free** | Ollama DeepSeek Coder v3 | Zero cost, fully offline |
+
+## Usage
+
+```bash
+# List all profiles
+omocs profile list
+
+# Switch to a profile
+omocs profile use ultra-mixed
+
+# Create a custom profile
+omocs profile create
+
+# Export/share a profile
+omocs profile export
+```