Work with agents
The agent chat
Write to the agent, attach files, keep a chat to a path with @, answer its requests and cards, and backtrack to an earlier message.
You talk to the agent through the message box under the chat. Type what to build, fix or check, attach files if they help, and press Enter.
Write and send
| Key | Action |
|---|---|
Enter | Send |
⇧Enter | New line |
⌘V | Paste text, or an image as an attachment |
Windows uses Ctrl in place of ⌘. What you type is kept per task until you send or clear it. If sending fails, the message and its files come back to the box.
While the agent works, you can keep typing: press Enter to queue a message for after the current turn, or press Stop to end the turn now.
To pick the model, use the picker beside Send. See Agents and models.
Attach files and images
Attach up to 10 files to a message: click Attach files, paste an image with ⌘V, or drag images onto the box. Pasted images can be up to 20 MB. Click an attachment to view it, or its cross to drop it before sending.
Keep the chat to a path with @
- Type
@and a few letters to search your repositories, folders and files. - Use
↑↓to move and↵to pick. On a repository or folder, press⇥to search inside it. - Press
Escto close the menu.
A pick shows as a tag and keeps the whole chat to that path, up to 10 paths. A repository not yet on the task shows adds it, and picking it attaches it. To remove a tag, put the cursor after it and press Backspace.
Answer the agent
When the agent needs you, a sheet rises over the message box and the task shows as waiting on you. Its title says what it wants, such as Dev wants to run a command, Dev wants to change a file, or Dev's plan is ready (read it in Preview).
- Permission: choose Yes, allow, No, or type in No, and tell Dev what to do instead… and press Enter.
- Questions: click a choice or press its number, or type in Type something else…. Use Next, Back and Submit, or Skip to decline.
- Ask first: a rule from your guardrails stopped an action. Choose Allow this once or Don't allow.
| Key | Action |
|---|---|
1–9 | Pick a choice. On a permission, 1 allows and 2 declines. |
Enter | Next question, or send |
Esc | Skip, or decline |
A note in the chat records your answer. More waiting requests show as +2 waiting and rise one after another. You can answer the same requests from the Zokie phone app.
Cards
An agent can add a card to a reply: numbers, check results, a table, a comparison, a plan's steps, a checklist, progress, a chart, a note or links. The buttons on its header:
- Show as text swaps the card for plain text. Copy as text copies it.
- Collapse folds it to its header. Expand opens it.
Some cards end with a question and answers; the first is the one the agent suggests. Click an answer, or click the card and press Enter or a number key. The card shows Replying with an Undo button for a few seconds, then sends it as your reply. To turn cards off, see config.json.
Backtrack
Backtrack takes a chat back to just before one of your messages. The files return to how they were, the later chat goes, the agent forgets it, and your message waits in the box to edit and send again.
- Hover a message you sent and click Backtrack under it.
- Backtrack to this message? lists the files that changed, how many messages go, other subtasks whose changes are undone too, and whether commits were already pushed.
- Click Backtrack.
Double-click your last message to skip the dialog. It stops the agent first if it is still working.
- Each repository's branch moves back on your Mac only. Pushed commits stay on GitHub until the next push.
- Files your repository ignores are never touched.
- You can't backtrack while the agent or another subtask in the same folder is working.
Claude Code and the Claude app
Chats Zokie starts with Claude Code don't appear in claude.ai or the Claude app, and can't be driven from there. To follow and steer your tasks away from your Mac, use the Zokie phone app.