start_session
Initiate a new PTY session with any command or shell, returning a session ID for subsequent operations.
Instructions
Start a new PTY session with any command or shell. Returns a session_id to use with other commands.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory for the session | |
| args | No | Optional explicit arguments for the command. If omitted, arguments are parsed from the command string. Use this for arguments with spaces or special characters. | |
| command | No | Command/binary to execute (default: $SHELL or /bin/bash). Can be 'python3', 'somebinary -a -b', etc. Arguments are auto-parsed from the command string if 'args' is not provided. | |
| buffer_size | No | Scrollback buffer size in lines (default: 1000) | |
| timeout_session | No | Idle timeout in seconds (default: 86400) | |
| sentinel_command | No | Command template to echo sentinel. Use {sentinel} placeholder. Default: 'echo {sentinel}'. For Python REPL: "print('{sentinel}')" |