Docs›By agent
Gemini CLI in Devalley
A Gemini CLI session is a resident in Devalley that shows whether it is working, waiting for you or done, and it has a line on the usage card. Its approval requests can't be answered from the village, though: they are answered in Gemini CLI's own terminal.
Its resident
Every Gemini CLI session you run becomes a resident of your village. The same agent in the same project is the same resident each time, with the same name and look, and a second session beside it joins as a companion. While the session works the resident is at a workplace; when a turn ends it cheers Done!; with nothing to do it rests. Click a resident for its card: its state in a word (Working, Needs you, Answer ready, Resting, Off, Error), its project and what you last asked it. Open conversation shows what it last answered.
Connect Gemini CLI at the village's telegraph office, or with Connect agents at the bottom right of the map. A running session moves in even before that, showing whether it is working or resting; once connected it also shows what it asks and what it answered.
Notifications
With Walking residents on, the resident strolls along the bottom of your screen with its name and project under its feet. When Gemini CLI asks you something it hurries to the middle of the screen and hops with a ? until you answer; when a turn is done it jumps and cheers Done!. On a Mac, At the notch shows the same beside the notch at the top of the screen. Devalley plays no sound and sends no system or phone notification.
Answering it from the village
When Gemini CLI asks for approval its resident shows that it is asking, but the answer is given in Gemini CLI's terminal; Terminal in its conversation brings that window forward. The conversation shows its last answer.
The usage card
The usage card has a line for Gemini CLI: how much of its limit is used and how long until it resets. Click it for each limit's used share and reset time, and the tokens used today and over the last 7 days, by project. On a Mac the agent nearest its limit stands in the menu bar, as in "Claude 48%"; on Windows the tray's Village window > Usage only keeps a small card on screen. When Gemini CLI's sign-in has expired, the card shows a sign-in button.
Google moved Gemini CLI's free individual access and its Google AI Pro and Ultra access to the Antigravity CLI on June 18, 2026 (the notice in Gemini CLI's repository). So where the Antigravity CLI is installed, the usage card's line for Google shows the Antigravity CLI's weekly limits in place of Gemini CLI's.
Windows and macOS
| Windows | macOS | |
|---|---|---|
| Its resident and state | Yes | Yes |
| Walking residents | Yes (above the taskbar) | Yes (beside the Dock) |
| At the notch | No | Yes |
| Answering approval requests | In its terminal | In its terminal |
| Usage | The tray's "Usage only" card | In the menu bar |
| Waking a session that is off, with no terminal window | No | No |
| Sessions inside WSL | Connected too | Not applicable |
What doesn't work
- Its approval requests can't be allowed or denied from the village: answer them in Gemini CLI's terminal.
- A session that is off can't be woken from the village.
- When a session can't be written to from the village, its conversation says so.
- The usage card shows no cost in dollars.
- No sound, system notification or phone notification, and nothing can be answered from a phone.
- No Linux installer yet.