Create OpenCode session
opencode_session_createCreates a new OpenCode session in a specified directory, defaulting to the client's workspace. Set an agent, model, title, or permissions, and pass a parent session ID to spawn a child subagent session.
Instructions
Create a new OpenCode session in a directory. Defaults to the client's current workspace. Use agent='build' for implementation work, 'plan' for planning, and 'general'/'explore' for subagents. Pass parentSessionID to create a child (subagent) session.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "opencode_session_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | Agent id, e.g. build, plan, general, explore | |
| model | No | Explicit model, e.g. { providerID: 'opencode', id: 'iceman-free' } | |
| title | No | ||
| directory | No | Absolute working directory for the session | |
| permissions | No | Per-session permission ruleset | |
| parentSessionID | No | Makes this a subagent session |