Skip to content
Retask Docs

Private VM quickstart

A Private VM is your own machine connected to Retask so sessions can run there — see Private VM sandboxes for the why. This page is just the commands, start to finish in about five minutes.

1. Install the CLI

Section titled “1. Install the CLI”
Terminal window
curl -fsSL https://retask.work/install.sh | sh

2. Create a token

Section titled “2. Create a token”

Create a personal access token at app.retask.work/access-tokens.

3. Authenticate

Section titled “3. Authenticate”
Terminal window
export NWEB_API_KEY="nweb_pat_..."
retask auth login

4. Create the sandbox

Section titled “4. Create the sandbox”
Terminal window
retask sandbox create \
  --name "Private VM" \
  --type PRIVATE \
  --sharing WORKSPACE_EDIT \
  --session-init-command 'claude --dangerously-skip-permissions "$SEED_PROMPT"' \
  --integration-provider-id github

The command prints the new sandbox_id — copy it for the next step. Swap the init command for codex --yolo "$SEED_PROMPT" if you use Codex instead.

5. Connect your machine

Section titled “5. Connect your machine”
Terminal window
retask sandbox connect <sandbox-id>

That’s it — the machine goes Ready in the app, and stays connected for as long as the command runs. Press Ctrl-C and it goes offline.

Next steps

Section titled “Next steps”

Full details — sharing options, running work on it, what the machine’s owner can see, troubleshooting — are all in Private VM sandboxes.