Repository navigation
Port commands to V2 #34685
Description
Commands are still served and executed through the older packages/opencode command/session prompt path.
Current state:
- command.list is handled by packages/opencode/src/server/routes/instance/httpapi/handlers/instance.ts through the legacy Command.Service.
- /session/:id/command is handled by packages/opencode/src/server/routes/instance/httpapi/handlers/session.ts through SessionPrompt.command.
- packages/core/src/command.ts has CommandV2 and the V2 plugin graph can populate it, but the public command list and slash command execution paths do not use it yet.
We need to port commands to V2 end-to-end while keeping the public API simple:
- Keep the public command list shape simple.
- Keep command execution as a simple command + arguments request.
- Keep plugin command transforms simple for static templates unless we intentionally design dynamic plugin commands later.
- Add whatever internal command resolution machinery V2 needs.
Blocked work:
- MCP prompts as V2 slash commands in feat(core): support mcp prompts #34531 depends on this port for correct end-to-end behavior.
- Dynamic MCP prompt resolution should happen at command execution time with actual user arguments, which likely belongs in the V2 command execution/resolution path rather than in the public command catalog.
- Async MCP prompt list refresh work in Support async updates for MCP prompts in V2 #34541 also depends on having a V2 command path to update.
Activity
opencode-agent commentedon Jul 2, 2026
Tracker update from V2 TODO LIST audit (2026-07-02):
This remains the canonical V2 command-port tracker.
Known dependents / related work:
session.commandAPI surface.Suggested implementation direction remains: port command list + command execution/resolution to V2 while keeping public command list and execution request shape simple.
opencode-agent commentedon Jul 2, 2026
Additional tracker update (2026-07-02):
Related open PR:
authcommand listing authenticated providersThis is adjacent CLI command-surface work, but it does not complete
session.commandor slash-command execution. Keep #34685 open for end-to-end V2 command list/execution/resolution.opencode-agent commentedon Jul 2, 2026
Tracker update from V2 TODO LIST (2026-07-02):
@rekram1-node has an open PR for V2 command invocation:
PR scope includes:
/reviewas a normal command for nowFollow-ups noted by the PR:
Keep this issue open until #34849 lands and command execution is verified in TUI/client.
opencode-agent commentedon Jul 2, 2026
Tracker update from V2 TODO LIST (2026-07-02): @rekram1-node has an open PR for V2 command invocation: #34849. PR scope includes V2 session command invocation, durable prompt admission for commands, MCP prompts as command-shaped entries resolved at invocation time, /review as a normal command for now, and generated client updates. Follow-ups noted by the PR: #34847 subtask/backgrounding decision and #34860 MCP prompt optimistic UI. Keep this issue open until #34849 lands and command execution is verified in TUI/client.
opencode-agent commentedon Jul 2, 2026
Landed via #34849.
V2 command invocation now expands commands into normal durable prompt admission, exposes MCP prompts as command-shaped entries, resolves MCP prompts at invocation time, and adds the V2
session.commandAPI/client surface.Source update from Aiden: https://discord.com/channels/1391832426048651334/1520962938733723720/1522286030844199043