changes

• Introduced a new command 'subagents' to allow users to configure subagent-model assignments via an interactive TUI.
• Updated schema to include 'subagents' in the list of builtin command names.
• Added a new template for the 'subagents' command detailing the two-step TUI flow for user interaction.
• Enhanced the command definitions to support the new functionality.

Summary

• Add /subagents command for interactive TUI-based subagent-model configuration
• Enable non-technical users to configure model assignments without editing JSON files manually
• Implement two-step selection flow: list agents → select model → apply and confirm

Motivation

Previously, users had to manually edit oh-my-opencode.json to change subagent model assignments. This was:

• Error-prone - JSON syntax errors, typos in model names
• Non-intuitive - Users didn't know available options
• Confusing for non-developers - Required understanding of config file structure

The /subagents command provides a user-friendly TUI that guides users through the configuration process.

Changes

how it works

User types: /subagents

     │
     ▼
┌─────────────────────────────────────────┐
│ OpenCode detects /subagents command     │
│ Looks up in commands.ts registry        │
└─────────────────────────────────────────┘
     │
     ▼
┌─────────────────────────────────────────┐
│ Injects SUBAGENTS_TEMPLATE into prompt  │
│ AI now knows the TUI protocol           │
└─────────────────────────────────────────┘
     │
     ▼
┌─────────────────────────────────────────┐
│ AI displays Step 1 (numbered list)      │
│ WAITS for user input                    │
└─────────────────────────────────────────┘
     │
     User enters: 2
     │
     ▼
┌─────────────────────────────────────────┐
│ AI displays Step 2 (model selection)    │
│ WAITS for user input                    │
└─────────────────────────────────────────┘
     │
     User enters: 1
     │
     ▼
┌─────────────────────────────────────────┐
│ AI edits oh-my-opencode.json            │
│ Shows success toast                     │
│ Loops back to Step 1                    │
└─────────────────────────────────────────┘

Test plan

• bun run typecheck - passes
• bun run build - compiles successfully
• Manual testing in OpenCode:
  • /subagents displays numbered list of all agents
  • Shows ✨ for custom/overridden models, 📌 for defaults
  • Number input navigates to model selection
  • Model selection updates config file
  • Success toast displays after save
  • Returns to agent list for additional changes
  • exit command exits the TUI

Screenshot

Testing

bun run typecheck
bun test

Related Issues

Address issue #678