Docs

Installing, connecting, living in the village

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.