grok_delegate_start
Start Grok coding tasks in the background for real lanes, returning a job_id immediately to avoid client timeouts and empty worktrees. Poll with grok_delegate_poll.
Instructions
Start grok_delegate in the BACKGROUND and return a job_id immediately. Use this instead of grok_delegate for real lanes: a lane runs for minutes and a synchronous call is killed by the client timeout, leaving an empty worktree. Poll with grok_delegate_poll. Same guarded profile, no push, no merge.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | Coding goal for the executor | |
| lane | Yes | Lane slug or grok/<slug> (not dev/master/main) | |
| model | No | Optional model id | |
| rules | No | Optional extra rules appended to system prompt (bounded) | |
| resume | No | Resume session: true for most recent, or a session UUID string | |
| sandbox | No | Optional sandbox profile override: off|workspace|devbox|read-only|strict (known built-ins only) | |
| base_ref | No | Git base ref (default origin/dev) | origin/dev |
| max_turns | No | Max agent turns (server hard-capped at 60) | |
| plan_only | No | If true, use read-only permission profile | |
| repo_root | No | Absolute path to a repo root; accepted only if it resolve()s to an entry on GROK_DELEGATE_ALLOWED_ROOTS (or single GROK_DELEGATE_REPO_ROOT pin) | |
| session_id | No | UUID for --session-id (new or forked session name) | |
| json_schema | No | Optional JSON Schema object/string for structured output | |
| fork_session | No | Pass --fork-session (requires resume/continue) | |
| lane_verdict | No | Attach the lane verdict schema (default true). The run ends when the executor emits that object, so on a goal it must read the codebase to start, it emits one describing intent and the lane closes empty. Set false for exploration-heavy goals: the executor then works to natural completion and reports prose in summary instead of a parsed verdict. | |
| lanes_parent | No | Optional parent dir for worktrees; rejected if inside repo_root or outside GROK_DELEGATE_LANES_PARENT when that env is set | |
| no_subagents | No | If true, pass --no-subagents | |
| continue_session | No | Pass --continue (most recent for cwd) | |
| reasoning_effort | No | Optional reasoning effort (low|medium|high|…) | |
| disable_web_search | No | If true, pass --disable-web-search |