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

Closed
opened 2026-02-16 18:11:05 -05:00 by yindo · 2 comments
Owner

Originally created by @raymelon on GitHub (Feb 9, 2026).

Originally assigned to: @rekram1-node on GitHub.

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

Image Image

Operating System

Windows 10

Terminal

Warp

Originally created by @raymelon on GitHub (Feb 9, 2026). Originally assigned to: @rekram1-node on GitHub. ### 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): ```json { "$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 <img width="1068" height="200" alt="Image" src="https://github.com/user-attachments/assets/38c0ff11-9b86-4f0b-bbc8-550cf28b7ffa" /> <img width="1056" height="215" alt="Image" src="https://github.com/user-attachments/assets/35a39a70-7f4a-453e-a30e-cfabffd5df6b" /> ### Operating System Windows 10 ### Terminal Warp
yindo added the windowsopentuibug labels 2026-02-16 18:11:05 -05:00
yindo closed this issue 2026-02-16 18:11:05 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Feb 9, 2026):

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

  • #7496: Question Tool Keyboard Conflict and Agent Switch Issue - Tab key causing unintended agent switching due to keyboard event handling
  • #10878: Active primary agent is swapping during use without my asking it to - agents switching unexpectedly when multiple primary agents are configured
  • #8867: Blocked TAB switching during predefined answer selection - Tab key behavior affected by UI state during agent switching
  • #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

@github-actions[bot] commented on GitHub (Feb 9, 2026): This issue might be a duplicate of existing issues. Please check: - #7496: Question Tool Keyboard Conflict and Agent Switch Issue - Tab key causing unintended agent switching due to keyboard event handling - #10878: Active primary agent is swapping during use without my asking it to - agents switching unexpectedly when multiple primary agents are configured - #8867: Blocked TAB switching during predefined answer selection - Tab key behavior affected by UI state during agent switching - #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
Author
Owner

@raymelon commented on GitHub (Feb 9, 2026):

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

Shutting this down. Lol.

Image
@raymelon commented on GitHub (Feb 9, 2026): Saw the reason now. It's the .opencode/agent Shutting this down. Lol. <img width="421" height="153" alt="Image" src="https://github.com/user-attachments/assets/530d2846-12cb-4886-a9c6-37bfd36bc7ae" />
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#8880