Tab key cycles through 4 agents (including README/WORKFLOW) after setting a global opencode.json

[raymelon]

Description

So I was messing with my config and noticed something weird. When I hit Tab to switch agents, it cycles through:

plan → build → README → WORKFLOW

And then back to plan. That's 4 agents total.

But from the docs, I thought Tab only switches between the "primary" agents like build and plan? The docs say "For primary agents, use the Tab key to cycle through them" and list build and plan as the only user-facing primary ones.

I get that compaction, summary, and title are background system agents (makes sense, they run automatically). But README and WORKFLOW showing up in the Tab cycle seems off? I thought those were just permission contexts that apply to all agents, not selectable agents I can "become".

Is this intentional behavior or a bug? If it's intentional, maybe the docs need updating because it's confusing to see 4 items in the cycle when you expect 2.

My opencode.json config (in case it's relevant):

{
  "$schema": "https://opencode.ai/config.json",
  "small_model": "openrouter/google/gemma-3-4b-it:free",
  "provider": {},
  "default_agent": "plan",
  "autoupdate": false,
  "mcp": {
    "gh_grep": { "type": "remote", "url": "https://mcp.grep.app" },
    "context7": { "type": "remote", "url": "https://mcp.context7.com/mcp" }
  }
}

Plugins

none

OpenCode version

1.1.52

Steps to reproduce

1. Set a global opencode.json with the same content as I provided
2. Restart OpenCode
3. Switch through agents by pressing Tab
4. Expect to see README (in blue) and WORKFLOW (in RED) workflows

Screenshot and/or share link

Operating System

Windows 10

Terminal

Warp

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• Question Tool Keyboard Conflict and Agent Switch Issue #7496: Question Tool Keyboard Conflict and Agent Switch Issue - Tab key causing unintended agent switching due to keyboard event handling
• Active primary agent is swapping during use without my asking it to #10878: Active primary agent is swapping during use without my asking it to - agents switching unexpectedly when multiple primary agents are configured
• Blocked TAB switching during predefined answer selection and logical inconsistency in Plan Mode prompts #8867: Blocked TAB switching during predefined answer selection - Tab key behavior affected by UI state during agent switching
• [FEATURE]: ability to hide agents from tabbing #12530: Ability to hide agents from tabbing - related feature request about controlling which agents appear in Tab cycling

Feel free to ignore if none of these address your specific case.

For keybind-related issues, please also check our pinned keybinds documentation: #4997

[raymelon]

Saw the reason now. It's the .opencode/agent

Shutting this down. Lol.