[Bug]: OpenCode project-local agents are missing from the agent picker

[KostasKgr]

Before submitting

• I searched existing issues and did not find a duplicate.
• I included enough detail to reproduce or investigate the problem.

Area

apps/server

Steps to reproduce

1. Create a project-local OpenCode agent at .opencode/agent/readonly.md inside a project's folder, not global config:

   ---
   description: Read-only agent for inspecting the project.
   mode: all
   permission:
     edit: deny
     bash: deny
     todowrite: deny
   ---
   
   You are a read-only agent.

2. From the project directory, run:

   opencode agent list

3. Confirm that OpenCode reports the project-local agent:

   build (primary)
   plan (primary)
   readonly (all)
   

4. Add or open the same directory as a project in T3 Code.

5. Select the OpenCode provider and open the agent selector.

Expected behavior

T3 Code should include visible project-local OpenCode agents whose mode is primary or all.

The readonly agent should appear alongside the built-in build and plan agents, matching the agents OpenCode reports when invoked from that project directory.

Actual behavior

The project-local readonly agent is absent from the T3 Code agent selector.

The OpenCode provider cache contains only the globally discovered build and plan agents, even though:

• The chat session is started with the correct project directory.
• opencode agent list from that directory reports readonly (all).
• The agent definition is valid and available in the native OpenCode interface.

This appears to happen because OpenCode agent capabilities are cached at the provider-instance level using a discovery directory that can differ from the selected project's directory. Project-local agents are therefore not represented in the cached model capabilities used by the composer.

Impact

Major degradation or frequent failure

Project-specific agents are a supported OpenCode configuration mechanism. Their absence means workflows and permission profiles defined by individual projects cannot be selected through T3 Code.

Version or commit

• T3 Code: 0.0.40
• OpenCode: 1.18.31

Environment

Linux, T3 Code web/server mode, OpenCode provider.

Logs or stack traces

# From the affected project:
$ opencode agent list

build (primary)
compaction (primary)
explore (subagent)
general (subagent)
plan (primary)
summary (primary)
title (primary)
readonly (all)

# Agent options represented in ~/.t3/caches/opencode.json:
[
  "build",
  "plan"
]

The corresponding OpenCode session metadata confirms that T3 starts the chat with the affected project as its working directory.

Related issues

• [Bug]: OpenCode: custom agents from agent config key not enumerated (only default build shown) #7853 reported globally configured custom agents being omitted. It was closed after fix(opencode): handle child approvals, stops, and model catalogs #8480 changed discovery to OpenCode's native app.agents API. This report is different: globally available built-ins are discovered, but agents defined under a specific project's .opencode/agent/ directory are still absent.
• [Bug]: Cannot select other agents #9833 concerns the separate client-side feature flag that hides the built-in plan agent. It does not cover project-local agent discovery.

Workaround

Use the project-local agent through the native OpenCode tui or web ui. No T3 Code workaround is currently known.

[juliusmarminge]

Triage

Confirmed bug in OpenCode agent catalog discovery, not the picker UI.

T3 already filters correctly (!hidden and mode of primary or all). A project-local agent such as .opencode/agent/readonly.md with mode: all would appear if it were in the inventory. It never gets there.

Why

OpenCode agent options are baked into the provider-instance model snapshot during checkOpenCodeProviderStatus, using ServerConfig.cwd (the T3 process working directory), then written to ~/.t3/caches/opencode.json. That cache is one file per instance and does not include workspace snapshots.

Per-project refresh exists only for skills:

• OpenCodeDriver.snapshotForCwd reloads app.skills with the project directory
• ServerProviderWorkspaceSnapshot stores skills / slashCommands only
• composers resolve skills per cwd, but read the agent selector from instance-level models[].capabilities

Chat sessions already start with the correct project directory (adapter path). Catalog discovery does not follow that directory. That matches the report: opencode agent list shows readonly (all), while the cache only has build and plan.

This is the same class of cwd bug skills already fixed, left unfixed for agents after #8480 switched discovery to app.agents.

Not a duplicate

• [Bug]: OpenCode: custom agents from agent config key not enumerated (only default build shown) #7853 / fix(opencode): handle child approvals, stops, and model catalogs #8480 — global custom agents / app.agents. Built-ins are discovered; project .opencode/agent/ is not.
• [Bug]: Cannot select other agents #9833 — client flag hiding built-in plan. Unrelated to project-local discovery.
• No open PR clearly fixes .opencode/agent/ listing.

Suggested fix

Reload agents in snapshotForCwd via app.agents with the project directory, persist cwd-scoped agent options (workspace snapshot / contracts), and have web + mobile composers resolve the agent picker from that cwd the same way they resolve skills. Changing only the initial probe cwd is not enough: T3 is multi-project and the instance cache would still be a single list.

Surfaces

Server snapshot + cache first. Agent pickers on web, desktop (wraps web), and mobile all consume that catalog.