Skip to content
code flowerdocs

Quickstart: terminal and VS Code

  1. Check the machine can run sandboxes:

    Terminal window
    codeflower check

  2. Start a sandbox for a project, with your data read-only and a folder for results:

    Terminal window
    codeflower interactive --agent claude -p study42 \
      --input ~/data/study42 --output ~/results/study42

    Leave out --agent to be asked. The sandbox prints its address:

    codeflower://127.0.0.1:41234?token=…

    Anyone with this line can control the agent, so treat it like a password.

  3. Connect VS Code. In the code flower view in the activity bar, choose Connect to worker… (the +) (or run code flower: Connect to worker from the command palette) and paste the line. If the app’s window is running, the sandbox also prints a link that opens it there, and an Open in VS Code link.

  4. Sign in when VS Code offers it, the first time in a project. See Signing in agents.

  5. Chat. Choose New session (the speech bubbles next to the worker).

Press Ctrl+C in the terminal to stop the sandbox. Its chats, logins and installed software stay in the project, ~/codeflower/projects/study42, for next time.

Next

Section titled “Next”