Repository navigation
[FEATURE]: More prompt control in Agent V2 #53411
Description
Feature hasn't been suggested before.
- I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request
OpenCode is built for developers.
I want to:
- Create an Agent WITHOUT a prompt.
- Include "docs/**/prompt.md" files in the prompt WITHOUT "AGENTS.md".
- Execute code upon Agent creation.
I propose extending OpenCode V2 for Agent creation.
instructions
Currently, there are global instructions.
I propose adding agent.instructions:
- If
agent.instructionsis NOT defined, thenagent.instructions: ["**/AGENTS.md", ...global.instructions]. - If
agent.instructions: ["docs/**/prompt.md"], thenagent.instructions: ["docs/**/prompt.md"]WITHOUTglobal.instructions. - If
agent.instructions: [], thenagent.instructions: []WITHOUT files (Empty).
instructions are arguments for glob.
The resulting list must be sorted after each glob call, because the OS returns the list in random order.
agent.SystemPrompt
Add agent.SystemPrompt: false disables
myagent.ts
Only in the ~/.config/opencode/agents/ directory:
myagent.tsmyagent.jswhenmyagent.tsis not found- otherwise
myagent.md
myagent.ts returns an Agent Object/JSON schema.
This will allow creating an Agent with unique settings and a project-specific prompt.
Reacted by Jack Stringer
Metadata
Metadata
Assignees
Labels
No labels
Activity
github-actions commentedon Oct 5, 2026
This issue might be a duplicate of existing issues. Please check:
instructionsarray.AGENTS.mdinstructions.opencodejr commentedon Oct 27, 2026
Thanks for the detailed proposal, @Roffild!
If I understand correctly, you'd like more control over what goes into an agent's prompt in v2:
instructionslist that replaces the globalinstructionsandAGENTS.mddiscovery (with[]meaning no instruction files);~/.config/opencode/agents/myagent.ts/.js).Right now, v2 loads instructions the same way for every agent. The agent config can change
system, model, permissions and so on, but not which instruction files are included. Configured instruction globs are already sorted after matching, so that part should already hold.The third point can mostly be done today with a plugin: plugins can create and change agents in code through
ctx.agent.transform(...), for example to setsystemfrom project files. The first two can't be done from a plugin yet, because plugins can't filter the instructions that are added to a session's prompt.Maintainers will consider this request. I couldn't search for related issues this time, so a duplicate may turn up later.