happy_start_session
Start a new AI coding session on a specified machine with optional Git worktree isolation and environment configuration for development tasks.
Instructions
Start a new Happy AI session on a machine. Use happy_list_machines to find available machines first. Use happy_list_environment_sets to see available environment presets. Optionally create a Git worktree for isolated development.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| machine_id | Yes | The machine ID to start the session on | |
| directory | Yes | The directory path to run the session in (base repository path if using worktree) | |
| message | No | Optional initial message to send to start the session working | |
| agent | No | Agent type to use (default: claude) | |
| wait | No | If true, wait for AI to finish processing initial message before returning (default: false) | |
| environment_preset_id | No | Optional ID of an environment preset to use (from happy_list_environment_sets). Preset variables are applied first, then custom variables override them. | |
| environment_variables | No | Optional custom environment variables as key-value pairs. These override any variables from the preset. | |
| worktree | No | Optional Git branch name for creating a worktree. If provided, creates a new branch and worktree at .dev/worktree/<name> and spawns the session there. The directory must be a Git repository. |