Docs›By agent
Antigravity in Devalley
An Antigravity CLI (agy) session is a resident in Devalley. Its resident tells you when it waits for you with an approval or a question, and the usage card shows its weekly limits. The Antigravity app and IDE show status only.
Its resident
Every Antigravity 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 Antigravity 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 Antigravity 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 the Antigravity CLI stops on an approval or a question, its resident shows that it is asking. For a session whose question the conversation can show, the approval or question appears there with its choices and you click one. Otherwise answer in its terminal.
Several Antigravity CLI sessions in one folder keep separate conversations; with several in one folder, read each session’s messages in its own terminal. On a Mac, a message to a session that is off wakes it on the same conversation with no terminal window.
The usage card
The usage card shows the Antigravity CLI's weekly limits: one for Gemini models and one for Claude and GPT models, each with the time until it resets. Where the Antigravity CLI is installed, this line stands in place of Gemini CLI's. Tokens aren't counted for Antigravity.
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 approvals and questions | In the conversation where it shows them, otherwise in its terminal | In the conversation where it shows them, otherwise in its terminal |
| Usage (weekly limits) | The tray's "Usage only" card | In the menu bar |
| Waking a session that is off, with no terminal window | Not on Windows itself | Yes |
| Sessions inside WSL | Working or resting only | Not applicable |
What doesn't work
- The Antigravity app and IDE show status only: continue messages, commands and approvals in their own windows.
- There is no Allow or Deny brought by a resident with May I? for Antigravity.
- The usage card counts no tokens for it.
- On Windows itself a session that is off can't be woken, and an older Antigravity CLI has to be updated before it can be.
- The Antigravity CLI inside WSL isn't connected: it only shows as working or resting.
- No sound, system notification or phone notification, and nothing can be answered from a phone.
- No Linux installer yet.