CLI

npm install -g @twillai/cli

twill login --api-key twill_xxx
twill whoami   # verify
twill logout

# create
twill task create --command "Fix the flaky signup test" \
  [--mode code|plan|ask|dev_env] \
  [--agent claude-code/opus] \
  [--effort low|medium|high|xhigh] \
  [--title "..."]

# inspect & iterate
twill tasks                       # list
twill task <slug>                 # details
twill task continue <slug> --message "also update the docs"
twill task logs <slug>            # stream live logs
twill task archive <slug>
twill resume <slug>               # open the task in the TUI

twill automation create --title "Issue triage" \
  --message "Triage new GitHub issues: label, prioritize, summarize" \
  --cron "0 9 * * 1-5" [--timezone Europe/Paris]

twill automations                 # list
twill automation <id>             # details
twill automation edit <id> --cron "0 10 * * 1"
twill automation pause|resume|delete <id>

twill teleport <task-slug>        # writes a local Claude Code session
claude -r <sessionId>             # resume it

twill ssh                         # SSH into the workspace VM
twill fork scratch                # fork the VM under a name, then SSH in
twill ssh scratch                 # reconnect to that fork