Your first session
This walkthrough changes one endpoint and takes it to the workspace: edit, build, commit, approve. It uses the two-panel interface; the same steps as one-shot commands are at the end.
Open curio
curio
Sudo runs across the screen, then the commander opens. The left panel is the session's sandbox, starting in /workspace. The right panel is the folder you started curio in. The header shows the workspace, your account, the session, how many files it changed, and live when the live connection is up.
┌ curio https://acme.curiosity.ai | admin | session: fix-search | live ─────────────────┐
╔╡ sandbox:/workspace/code/endpoints ╞════════╗╔╡ local:/home/me/defs ╞══════════════════════╗
║ /.. ║║ /.. ║
║ search-orders.cs 2.1K 09-29 12:04 ║║ notes.md 1.2K 09-28 17:10║
╚═════════════════════════════════════════════╝╚═════════════════════════════════════════════╝
/workspace/code/endpoints$
1Help 2Sessions 3View 4Edit 5Copy 6Move 7Mkdir 8Delete 9Changes 10Quit
Edit a file
Go to /workspace/code/endpoints with the arrow keys and Enter, select an endpoint and press F4. Save with Ctrl+S. The file is now marked M: it is an uncommitted change of this session, and the workspace has not changed.
To edit in your own editor instead, copy the file to the right panel with F5, edit it there, and copy it back with F5.
Build it
Type build and press Enter. Typing anywhere starts a command, and it runs in the sandbox, in the left panel's directory. The build checks the changed definitions against the workspace. Output longer than a line opens the console; Ctrl+O toggles it.
Commit and approve
Press F9. The Changes dialog lists the files the session changed, with a diff for the one you select. Choose Commit…, write a message, then Approve.
If this curio may not approve by itself (the default), Approve opens the commit on Sudo's review screen in your browser. Approve it there. curio waits, and says when the change is live.
The same, as commands
curio get /workspace/code/endpoints/search-orders.cs # download it
# edit search-orders.cs in your editor
curio put search-orders.cs /workspace/code/endpoints/ # an uncommitted edit
curio run -- build
curio run -- commit -m "Open orders first"
curio commit approve
Next
- The two-panel interface, in full.
- Sessions and the sandbox: what else is in the sandbox, and how sessions relate to the admin dock.
- Coding agents: let Claude Code or Codex do the edit for you.