Get started
Workspace
How the Velork window is laid out. The Agents and IDE layouts, the Canvas, Editor, and Tasks views, the agents panel, chat sessions, and project folders.
Velork has two layouts. Agents puts the chat first, with a side panel for the canvas, browser, files, and terminal. IDE is the full VS Code layout with the chat beside the editor. Both work on the same project folder, so you can switch at any time.
Switch between Agents and IDE
The layout button in the title bar shows the layout you can switch to: Agents while you're in the IDE, IDE while you're in Agents.
- Click it, or press Cmd + Shift + F
- Command: Toggle Velork Chat Fullscreen
The Agents layout isn't available from the Tasks view. There, Cmd + Shift + F runs Find in Files as in VS Code.
Open a project
Velork works on folders on your disk. Code, chats, and the canvas all belong to the open folder.
- In the chat composer, use the workspace selector: Open Folder… or Connect via SSH…
- In the IDE, use File → Open Folder…
- In Agents, press Cmd + P and choose Open Folder… under actions
The Agents layout
The chat fills the window. Next to it, the agents panel holds tabs for the work Agent is doing:
| Tab | Shortcut | Use it for |
|---|---|---|
| Browser | Cmd + Option + 1 | Run and test your app in the built-in browser |
| File | Cmd + Option + 2 | Open and edit a file |
| Terminal | Cmd + Option + 3 | Run commands |
| Review Changes | Cmd + Option + 4 | See every file Agent changed as a diff |
| Canvas | Cmd + Option + 5 | Design next to the chat |
| Spend | Cmd + Option + 6 | See your AI usage and cost |
| Cloud computer | Cmd + Option + 7 | Watch Agent's cloud computer and take over |
Show or hide the panel with Cmd + Option + B. Press Cmd + T in the panel to open a new tab. When the panel has no tabs, press a letter to pick the type: B Browser, F File, T Terminal, D Review Changes, C Canvas, S Spend, M Cloud computer.
Press Cmd + P to search sessions, files, actions, and settings. To move the chat to the other side of the window, run Move Chat to Other Side or use its button in the title bar. It works in the IDE layout too.
The IDE layout
The IDE layout has three views. Switch from the title bar or with a shortcut:
| View | Shortcut | Use it for |
|---|---|---|
| Canvas | Cmd + Option + C | Design with layers, paste from Figma, capture websites, motion, and 3D |
| Editor | Cmd + Option + E | Files, terminal, Git, extensions, and debugging |
| Tasks | Cmd + Option + T | The task board, task details, and channels |
Commands: Switch to Canvas View, Switch to Editor View, Switch to Tasks View.
The chat stays in the secondary side bar across all three views. The built-in browser (Cmd + Option + 1) and Review Changes (Cmd + Option + 4) work in the IDE layout too.
To see your running app next to the design, see Preview. To capture a website onto the canvas, see Capture websites.
Run several chats
Each chat is a session with its own agent. With focus in the chat, press Cmd + T for a new one and Cmd + W to close the current one. Move between them with Cmd + Shift + ] and Cmd + Shift + [.
In the Agents layout, sessions show as Tabs above the chat by default. You can switch to a Sidebar in Settings → General → Sessions, or run Switch Sessions Between Sidebar and Tabs. With tabs, Tabs by workspace groups chats when you work in several folders. See Sessions.
Open Settings
Click the Settings button in the title bar or press Cmd + ,. In the Agents layout, Settings opens as a tab in the agents panel. In the IDE, it opens in the editor. See Settings.
If every panel is closed
When you close the editor, side bars, and chat, Velork shows All panels are closed with three buttons: Open Canvas, Open Chat, and Open Editor.