start_remote_control
Start or resume a native Claude Code session with Remote Control enabled, allowing Codex to manage persistent conversations across refreshes. Uses per-user broker on Windows, tmux on Linux/macOS.
Instructions
Start or resume a native Claude Code session with Remote Control enabled. Windows sessions are owned by a persistent per-user broker so Codex tasks can reconnect after refresh; Linux/macOS sessions use tmux.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Project directory. If RAIL_CONNECTOR_ALLOWED_ROOTS is set, cwd must be inside one of those roots. | /root |
| bare | No | Start Claude with --bare. This may bypass normal keychain/OAuth configuration. | |
| model | No | Optional Claude model alias or full model name passed as --model. | |
| tools | No | Optional Claude --tools list. This controls the available built-in tool set. | |
| effort | No | Optional Claude effort passed as --effort. | |
| safeMode | No | Start Claude with --safe-mode for troubleshooting. | |
| sessionId | No | Existing Claude session id to resume. Omit to start a fresh session. | |
| ultracode | No | Request session-scoped Ultracode. The MCP prefers an advertised effort value; generic settings are experimental and unverified. Do not combine with effort or safeMode. | |
| remoteName | No | Remote Control display name. This does not rename the Claude conversation. | Rail-Connector |
| forkSession | No | Fork when resuming or continuing, using Claude's --fork-session. Requires sessionId or continueLatest. | |
| tmuxSession | No | Deprecated alias for managedSession. | |
| allowedTools | No | Optional Claude --allowedTools list. This pre-approves tools; it does not replace --tools. | |
| killExisting | No | Kill an existing managed session with this name before starting. | |
| newSessionId | No | Optional UUID to assign to a new Claude conversation. Do not combine with sessionId or continueLatest. | |
| resumeChoice | No | If Claude asks how to resume a large session, optionally choose summary, full, or don't ask again. | none |
| sessionTitle | No | Optional title for a new Claude conversation. Use rename_claude_session after launch for later changes. | |
| axScreenReader | No | Start Claude with --ax-screen-reader for flatter terminal output when supported. | |
| continueLatest | No | Resolve the latest local conversation for this cwd to an exact UUID, then resume it. | |
| managedSession | No | Managed terminal session name. | rail-connector-managed |
| permissionMode | No | Semantic Claude permission mode. default resolves to the installed CLI's default/manual alias. bypassPermissions also requires confirmBypassPermissions and an acknowledged RAIL_CONNECTOR_ALLOW_BYPASS_PERMISSIONS policy. | default |
| trustWorkspace | No | Accept Claude's workspace trust prompt only when that prompt is detected. Defaults to false. | |
| disallowedTools | No | Optional Claude --disallowedTools list. This denies specific tools. | |
| confirmUltracode | No | Required with ultracode=true to acknowledge xhigh effort and dynamic workflow orchestration. | |
| forceKillExisting | No | Permit replacement of a busy session and force termination if graceful exit fails. | |
| resumeSessionName | No | Exact Claude conversation title to resolve to a UUID before launch. | |
| confirmBypassPermissions | No | Per-call acknowledgement required with bypassPermissions; the MCP process must separately acknowledge either local-host or isolated use through RAIL_CONNECTOR_ALLOW_BYPASS_PERMISSIONS. |