Agent UI Picker Visibility - Agents don't appear in /agents command

[Steffen025]

Problem

Migrated agents (intern, engineer, architect, etc.) work correctly via @agent-name invocation but do not appear in the /agents UI picker.

Current behavior:

• /agents shows only "Build Native" and "Plan Native"
• @engineer, @architect, @intern-sonnet, @intern-opus all work correctly
• Agent personalities and capabilities function as expected

Expected behavior:

• All 7 migrated agents should appear in /agents picker
• Users should be able to visually confirm which model variant is in use

Impact

Cost Control Risk: Without visual confirmation, users cannot verify which model (haiku vs opus) is burning tokens. An agent might silently use opus when haiku was intended.

Investigation

Hypothesis: The mode: subagent configuration in agent YAML files may prevent agents from appearing in user-facing pickers. Need to investigate:

1. mode: subagent vs mode: user configuration
2. OpenCode agent registration mechanism
3. UI picker filtering logic

Files to Investigate

• .opencode/agent/*.md - All agent definitions use mode: subagent
• OpenCode source code for agent picker logic

Acceptance Criteria

• All 7 agents appear in /agents UI picker
• Users can visually identify which model variant is active
• No regression in agent functionality

Related

• v0.4 Release: Agent Delegation Complete
• GitHub Discussion: PAI-OpenCode: PAI v3.0 Community Port to OpenCode — 🎉 RELEASE v2.0 danielmiessler/Personal_AI_Infrastructure#286

[Steffen025]

✅ Resolved in v0.4.1

This issue was fixed as part of the PAI-OpenCode v0.4.1 - Agent UI-Picker release.

Solution

Created .opencode/agent/ directory with 7 agent definitions:

• intern.md - High-agency generalist (haiku model)
• engineer.md - Code implementation specialist
• architect.md - System design and specifications
• researcher.md - Web research specialist
• designer.md - UX/UI design specialist
• pentester.md - Security testing specialist
• writer.md - Content creation specialist

Key Fixes Applied

• Used correct provider/model format (e.g., anthropic/claude-haiku-4-5)
• Shortened descriptions for UI picker display
• Added hex color codes for visual distinction

Validation

• All 7 agents visible in /agents picker ✅
• Single agent delegation works ✅
• Parallel agent delegation works ✅
• Users can now visually confirm which model variant is active ✅

Documentation: ${PAI_DIR}/history/execution/archive/2026-01-01-pai-opencode-v0.4.1-agent-ui-picker/