Work with agents
Code workspace
The right panel of a code task, its files, editor, terminal, language servers, dev server preview and simulator.
Every code task has a panel right of the chat with its files, changes, checks and a terminal. Windows uses Ctrl in place of ⌘ and Alt in place of ⌥.
The right panel
| Tab | What it shows |
|---|---|
Task details (⌘I) | The task's page: status, description and plans |
| All files | The task's folder, with search and an editor |
| Changes, Checks | Review and pull requests. See Review and ship |
| Terminal | A shell in the task's folder |
| Simulator | Shows while a simulator or Android device runs |
| Preview | Shows once an agent opens a dev server |
Drag a tab icon to reorder, or focus it and press ⌥↑ or ⌥↓. Drag the divider to resize; its arrow closes the chat.
Files and editor
Opening All files closes the chat; leaving it brings the chat back. ⌘B hides the file list.
| Key | Action |
|---|---|
⌘P | Find a file by name; name:line opens at a line |
⇧⌘F | Search text in every file |
⌘S / ⌘F / ⌘G | Save / find in file / next match |
⌃G | Go to line |
Text search offers Match case, Whole word and Regular expression. The box after in narrows it, e.g. src, *.go, !*.test.ts. Enter opens a result; F4 and ⇧F4 step through results.
Up to 12 tabs stay open. Binary files and files over 2 MB don't open. If the agent changes a file you are editing, a bar warns you; choose Reload or Keep mine.
Language servers
Hover help and go-to-definition work once you install a language server:
| Files | Install with |
|---|---|
.go | go install golang.org/x/tools/gopls@latest |
.py | npm install -g pyright |
.ts, .tsx, .js, .jsx, .mjs | npm install -g typescript-language-server typescript |
When one is missing, a bar above the editor shows the command to copy. Run it, then reopen the file. If Zokie still can't find it, check it runs in a new terminal window, then restart Zokie.
Terminal
Each task has one shell, shared with the agent, that keeps running while you switch tabs. With several repositories, pick one or Task folder. End shell stops it and everything it started.
- Click a
http://localhost:…address to open it;⌘-click copies its Live Link. See Integrations. - Agents type commands such as builds, tests and dev servers here, so you can watch and rerun them with
↑. - Some commands, such as
sudo, the agent asks you to run yourself.
Dev servers in Preview
Ask in the chat, e.g. "start the dev server and open it in Preview". The Preview tab appears with Reload, Open in browser and Close preview. It shows http://localhost servers on this computer only.
Simulator
The Simulator tab mirrors a running iOS Simulator (Mac with Xcode), Android emulator or Android device (Android SDK with adb). Zokie doesn't start them; start one or ask the agent.
- Click to tap, drag to swipe. Pick a device from the list when several run.
- On iOS, click the screen, then type;
⌘Vpastes,Escreturns the keyboard to Zokie. - Buttons: Home on iOS; Back, Home, Recents on Android.
- View only means your Xcode doesn't accept input; tap in the Simulator app instead.