How to Run Multiple Antigravity CLI Sessions in Parallel
Short answer: open the agy command more than once
To run multiple Antigravity CLI sessions in parallel, open a terminal, run agy, then open another terminal and run agy again. Each Antigravity CLI session is an independent process with its own conversation, its own context, and its own working state. Antigravity is Google's official successor to Gemini CLI, which was retired in June 2026, so where you used to type gemini you now type agy. If you are coming from the old tool, the Antigravity CLI vs Gemini CLI comparison covers what changed. Nothing is shared between the sessions.
That independence is what makes the parallelism safe. One session can refactor your API layer while another writes tests and a third updates docs. They will not collide unless two of them edit the same file. Antigravity signs you in with a Google account and comes with a generous free tier, and each terminal can reach for any of its eight built-in models (Gemini 3.x, Claude Sonnet 4.6, Claude Opus 4.6, GPT-OSS 120B and more), picked automatically for the task at hand. Spinning up several at once is practical and does not blow a metered budget.
There is no special multi-session plan to buy. Each terminal uses your own Google sign-in. Worth knowing: a single agy session is already multi-agent, it coordinates sub-agents to finish one task on its own. Running several independent agy sessions in parallel, each on a different task, is a separate idea, and that is what this guide is about. For how one session behaves by itself, see the Antigravity CLI guide.
The rest of this guide is about that organization problem. Here are the three methods, from the simplest to the most capable.
Method 1: Multiple terminal tabs (free, basic)
The fastest way to run Antigravity CLI in parallel is the one you already know. Open a few terminal tabs or windows, move into your project in each one, and start a session with agy.
If you have not installed it yet, Antigravity CLI is a single binary with no Node or Python to manage. One line gets you the agy command:
curl -fsSL https://antigravity.google/cli/install.sh | bash# Terminal tab 1
cd ~/my-project
agy
# Terminal tab 2
cd ~/my-project
agy
# Terminal tab 3
cd ~/my-project
agyEach tab now holds an independent Antigravity CLI session. Switch between them and give each one a different instruction. If you want a session to keep going without stopping for confirmation on every action, run it with agy --dangerously-skip-permissions for an unattended, auto-approving run. Use it with care, since a session that approves itself will run commands you might have wanted to review first.
Pros
- Free, nothing to install beyond the Antigravity CLI itself
- Works the second you open a tab, zero setup
- Easy to reason about, one tab equals one session
Cons
- You quickly lose track of which tab is running which task
- No notification when a session finishes or stops to ask something
- No shared view, you click into each tab to check on it
- No way to search across the conversation history of different sessions
- If two sessions edit the same file, the conflict is yours to resolve
- With three or more tabs they all start looking identical
For two sessions this is perfectly fine. Past that, the time you spend hunting through tabs starts canceling out the time the parallel sessions were meant to save. If you are choosing between agents first, the running multiple Claude Code sessions guide mirrors this exact method for Claude.
Method 2: tmux or screen (free, advanced)
If you are comfortable in the terminal, tmux gives you split panes and persistent sessions. You can watch several Antigravity CLI sessions on one screen without flipping between tabs.
# Start a new tmux session
tmux new-session -s antigravity
# Split horizontally
tmux split-window -h
# Split the right pane vertically
tmux split-window -v
# Now you have 3 panes - run agy in each onetmux also lets you detach and reattach, so your Antigravity CLI sessions keep running even after you close the terminal window. And if a session does end, agy can pick the thread back up: agy -c continues your last conversation, and you can resume a specific one by passing its id to agy --conversation. That helps when one session is grinding through a long migration in auto-approve mode and you want to step away.
Pros
- Free and available almost everywhere
- See several panes at once without tab switching
- Persistent sessions that survive disconnects
- Deeply configurable through dotfiles
Cons
- Real learning curve if tmux is new to you
- Still no desktop notification when an Antigravity session finishes
- No conversation history or search across sessions
- Text-only panes get cramped past 3 or 4 sessions
- No task board or organization layer for the work
- You rebuild the pane layout by hand every time
- Conflict resolution between sessions is still on you
tmux is a great tool and plenty of developers live in it. But it was built as a general terminal multiplexer, not as a control room for parallel AI sessions. The gaps become obvious once you run three or more Antigravity CLI sessions every day.
Method 3: CodeAgentSwarm (visual, full-featured)
CodeAgentSwarm is a desktop app built for exactly this: running several AI CLI sessions in parallel with real visibility and control. It runs on macOS and Windows, gives you multiple terminals in one workspace, and lets you choose the agent per terminal. To run Antigravity CLI in parallel you just pick "antigravity" in each terminal you want, and you can mix in Claude Code or Codex CLI alongside it.
It runs on top of your existing setup. CodeAgentSwarm is not a model provider, so each Antigravity session keeps using your own Google sign-in and your agy install. The app just gives the sessions a place to live. Here is what that adds:
Multiple Antigravity sessions in parallel
Run multiple terminals at once and set each one to antigravity through the SELECT AI AGENT picker. Each session is independent, with its own conversation and project context. If a task fits a different model better, you can point that one terminal at Claude Code or Codex CLI instead, all in the same window.
Real-time visibility with dynamic titles
Each terminal updates its own title based on what the session is doing right now. Instead of several identical "agy" tabs you see titles like "Migrating DB Layer", "Writing API Tests", "Refactoring Router". One glance tells you what every session is up to.
Desktop notifications
When an Antigravity session finishes its task or needs your input, you get a native desktop notification. You stop babysitting tabs to find out whether something is done. Focus on one session and let the others ping you when they actually need attention. The notification system guide goes deeper on how this works.
Searchable conversation history across sessions
Every conversation across every terminal is saved and searchable. You can find what an Antigravity session did yesterday, resume a thread, or review the full history of changes. When you run many sessions, being able to trace what happened where is what keeps the workflow from turning into noise.
A kanban task board sessions update over MCP
A kanban-style board connects to your terminals, and the sessions update it themselves over MCP, which Antigravity CLI supports. Create tasks, assign them, and watch the board move as work progresses. When two Antigravity sessions are building related features, the board keeps the big picture in one place.
Turbo Mode with granular permissions
Running several sessions means more actions happening at once, which makes permissions matter more. Turbo Mode auto-approves safe operations while keeping risky ones gated, so an Antigravity session can move fast without you waving through everything blindly. You set the line between what is automatic and what still needs a yes. The Turbo Mode guide covers the full setup.
Per-terminal live file diffs
When two sessions touch the same file, you can see it as it happens. CodeAgentSwarm tracks live file changes per terminal and at the project level, so overlapping edits do not surprise you later. The real-time changes guide has more on this.
Running Antigravity in parallel is one flavor of a broader pattern. For the full picture across agents start with the AI CLI agent swarm hub, then compare it with running multiple Codex CLI sessions.
Quick comparison
Here is how the three ways to run multiple Antigravity CLI sessions compare across what actually matters once you go past two:
Cost
- Terminal tabs: Free
- tmux/screen: Free
- CodeAgentSwarm: Free tier available, Pro for advanced features, runs on top of your Antigravity (Google) account
Setup time
- Terminal tabs: Zero, just open tabs
- tmux/screen: 10 to 30 minutes to learn the basics, more to customize
- CodeAgentSwarm: About 2 minutes to download and open
Notifications
- Terminal tabs: None
- tmux/screen: None unless you script something custom
- CodeAgentSwarm: Native desktop notifications when a session finishes or needs input
Conversation history
- Terminal tabs: Lost when you close the tab
- tmux/screen: Kept while the session is alive, no search
- CodeAgentSwarm: Saved permanently and searchable across every session
Mixing agents
- Terminal tabs: Possible, but you track it in your head
- tmux/screen: Possible with named panes, still manual
- CodeAgentSwarm: Pick antigravity, claude-code, or codex cli per terminal from one picker
Learning curve
- Terminal tabs: None
- tmux/screen: Moderate to steep (keybindings, config files, pane management)
- CodeAgentSwarm: Low, a visual interface with familiar patterns
If you only need two Antigravity sessions now and then, terminal tabs are fine. If you already live in tmux, adding Antigravity CLI sessions to your setup is natural. But once you run three or more sessions regularly and want to actually see what each one is doing, CodeAgentSwarm removes the friction the other two approaches leave behind.
FAQ
Open a terminal, run agy, then open another terminal and run agy again. Each session is an independent process with its own conversation and context. You can do this with plain terminal tabs, with tmux split panes, or in CodeAgentSwarm, which runs multiple terminals at once and lets you set each one to antigravity from the SELECT AI AGENT picker.
Yes, and there are two layers to it. A single agy session is already multi-agent: it coordinates sub-agents to finish one task. On top of that, because each agy session is a separate process, you can run as many sessions as your machine handles, each on its own task. They do not share memory and will only collide if they edit the same files.
In each terminal, change into your project directory and run agy. That is all it takes. tmux lets you split one window into several panes so you see every session at once, and CodeAgentSwarm gives you multiple visual terminals in one workspace with dynamic titles so you can tell them apart at a glance.
Yes. Since every terminal is independent, you can run an Antigravity CLI session next to a Claude Code session and a Codex CLI session. In CodeAgentSwarm you set the agent per terminal from the SELECT AI AGENT picker, so a mixed setup lives in one workspace with one shared, searchable history.
There is no hard limit from Antigravity CLI itself, since each session is just a process. In practice your machine resources, screen space, and the limits on your Google account are the constraints. CodeAgentSwarm supports multiple simultaneous terminals with a layout that keeps everything readable.
For many workflows, yes. Antigravity comes with a generous free tier behind a Google sign-in, and each session can use any of its eight built-in models (Gemini 3.x, Claude Sonnet 4.6, Claude Opus 4.6, GPT-OSS 120B and more), chosen automatically. That makes running several sessions in parallel practical without a metered bill per call. Heavy or sustained use can hit limits, so for large or long-running setups keep an eye on the limits attached to your account.
They do not share memory, so a conflict only appears when two sessions write to the same file. The second write can overwrite the first or create a Git conflict you resolve yourself. To avoid this, give each session a different slice of the codebase. CodeAgentSwarm adds per-terminal live file diffs so you can see overlapping edits as they happen.
Run multiple Antigravity CLI sessions in parallel with CodeAgentSwarm. Multiple terminals, one workspace, and a desktop notification the moment each agy session finishes.
Try CodeAgentSwarm