Agate, the assistant
Say what you want to do in your own words: Agate proposes the command or the action, and you decide.
Agate is Basalt's assistant. You say what you want in your own words — "why is nginx failing?", "show me what is using the disk" — and it proposes the command or the action. It never runs anything on its own: each thing comes as a card and happens when you tap it.
It is off by default. Turn it on in Settings → Agate; see the guide to Agate's models to choose what it runs on.
Opening it
- In a session, Ask Agate in the "…" menu.
- Swiping up from the key bar.
- From the server list, or with the Ask Agate shortcut on the Action Button.
When a command fails, a pill appears above the keyboard, Why did this fail?: tapping it opens Agate and asks. With text selected in the terminal, the pill offers to ask about the selection. The failure pill can be turned off in Settings → Agate.
It opens over the window, right above the keyboard, and the terminal stays visible behind it. When it is empty, it suggests where to start from what is on the screen.

What it sees
Above the field there are a few chips: the latest lines of the terminal in the active pane, the server and, if there is one, the selected text or the file in the editor. That is what goes with your question. Tap a chip to leave it out.
It never sees your keys or passwords, or anything typed while the server has echo disabled.
The cards
Each proposal comes as a card with what it does, in one line.
- Insert writes the command on the line, without Return, so you can review or change it.
- Run sends it. Anything that deletes, overwrites or stops something always asks first, and is shown in red.
- Under "…", Run in the other pane: it splits the window if needed. Useful for following a log while you work here. The same menu has Dismiss.
After Run, the card says the command is running. Agate waits for it to finish, reads what it printed and carries on: if you asked for several things, the next step appears in a bubble at the top, with its Run button, without covering the terminal. With three steps or more, the panel shows the list of steps and where it is. If the command stops to ask for something, such as a password, it tells you.
When it proposes several commands in a row, Run all chains them and stops at the first one that fails.
With Run without confirming turned off in Settings, Run asks for confirmation for commands that are not risky too.
Watching a terminal
Ask it to keep an eye out: "tell me when it finishes", "let me know if an error shows up in the log". Agate watches the output of that terminal, this one or the one beside it, and when what you were waiting for happens it tells you and proposes the next step. With the panel closed, the notice appears in a bubble at the top; tap it to open Agate.
While it is watching, the header shows a crossed-out eye: tap it to stop. It only watches while Basalt is open.
Replying to a message
Touch and hold a message, yours or Agate's, and choose Reply. The quote appears above the field and Agate knows what you mean. The same menu has Copy.
History
When you reopen Agate with nothing pending, it comes up clean; the clock in the header brings back the earlier messages, and the button next to it starts a new conversation.
Every conversation is saved in Settings → Agate → Chat history, with a title that sums it up. On this device only: it does not go to iCloud or its backups. Swipe to delete one, or use the trash to delete them all.
With the app closed
If you leave Basalt while Agate is waiting for your decision, the question arrives as a notification with Yes and No. Yes asks you to unlock the device.