OpenCode omoa Toggle

Toggle the oh-my-openagent plugin for OpenCode.

Purpose

oh-my-openagent adds multi-model orchestration, LSP tools, and other advanced features to OpenCode. However, it can interfere with normal operation. This tool provides a simple way to enable/disable it without modifying the config file.

How It Works

The solution uses:

1. State file (~/.config/opencode/omoa-enabled) — determines if omoa should be active
2. OPENCODE_CONFIG_CONTENT environment variable — injects the plugin at runtime (higher precedence than config file)
3. Post-upgrade script — removes plugin entry from opencode.json after running upstream installer

This approach:

• Keeps opencode.json clean (no plugin entry)
• Is compatible with upstream install script
• No file mutation, no backups, no restore

Files

• omoa — CLI command to toggle omoa on/off
• opencode-start.sh — Wrapper script that starts OpenCode with/without omoa (foreground)
• opencode-attach.sh — Attach TUI to the systemd server (shared sessions)
• omoa-post-upgrade.sh — Removes omoa plugin from opencode.json after upstream install
• omoa.mjs — Unified OpenCode skill for all omoa operations (toggle, status, post-upgrade)
• git-ops.mjs — OpenCode skill for git operations with Hibbhome Gitea server
• opencode-setup.mjs — OpenCode skill documenting the full system architecture
• README.md — This file

Installation

1. Copy files to ~/.config/opencode/
2. Make scripts executable:

   chmod +x ~/.config/opencode/omoa
   chmod +x ~/.config/opencode/opencode-start.sh
   chmod +x ~/.config/opencode/opencode-attach.sh
   chmod +x ~/.config/opencode/omoa-post-upgrade.sh
   

3. Symlink to PATH:

   ln -sf ~/.config/opencode/omoa ~/.local/bin/omoa
   ln -sf ~/.config/opencode/opencode-start.sh ~/.local/bin/opencode-start
   ln -sf ~/.config/opencode/opencode-attach.sh ~/.local/bin/opencode-attach
   ln -sf ~/.config/opencode/omoa-post-upgrade.sh ~/.local/bin/omoa-post-upgrade
   

4. Update systemd service to use wrapper:

   [Service]
   ExecStart=/home/kenny/.config/opencode/opencode-start.sh
   

5. Add skill to opencode.json:

   "skills": {
     "omoa": {
       "description": "Manage oh-my-openagent (toggle, status, post-upgrade)",
       "path": "/home/kenny/.config/opencode/skills/omoa.mjs"
     }
   }
   

6. Restart services

Usage

CLI Command (simplest)

omoa          # Toggle on/off
omoa on       # Enable
omoa off      # Disable
omoa status   # Check status

Attach TUI to systemd server (shared sessions)

opencode-attach        # Attach to systemd server
opencode-attach --omoa # Enable omoa, then attach

Start server directly (foreground, separate sessions)

opencode-start          # Start without omoa (vanilla)
opencode-start --omoa   # Start with omoa enabled

After upstream updates

omoa-post-upgrade  # Clean the plugin entry from opencode.json

Telegram Bot

Use /commands → omoa:

• omoa_status — Check if omoa is enabled
• omoa_enable — Enable omoa
• omoa_disable — Disable omoa
• omoa_toggle — Toggle omoa on/off
• omoa_post_upgrade — Clean opencode.json after upstream install

After Upstream Updates

When you run the upstream install script:

npx oh-my-openagent@latest install
omoa-post-upgrade  # Clean the plugin entry from opencode.json

Author

Kenny Hibbhome

Created

2026-05-03