Antigravity opens on the project, with the card on your clipboard
Antigravity is an IDE, so PortBay does not pretend to run it headless. It opens the app on the project folder and puts the card's brief on the clipboard — into a project that is already serving at a real URL.
How does PortBay dispatch Google Antigravity?
Differently from every other agent on the roster, and the difference is the point. Antigravity is an agentic IDE rather than a headless CLI: it cannot be driven non-interactively and it cannot take a prompt as a command-line argument. PortBay records that in the agent's own capabilities — headless is false, and prompt delivery is by clipboard — and behaves accordingly. Assign Antigravity to a card and PortBay opens the IDE on the project folder through the `antigravity` shim that Antigravity.app installs, with the card's brief copied to your clipboard so the first thing you do in the IDE is paste it. Everything around that stays the same as for a headless agent: the card is a Markdown file in your repo, the project is already serving on its own .test hostname with trusted HTTPS and a database attached, and the card moves through the board as the work lands. What you do not get is an unattended run — by design, because Antigravity does not offer one.
The IDE, opened on the card's project
No headless run and no pretence of one: the app opens on the folder, the brief is on the clipboard, the environment is already up.
Your first Antigravity card
Five steps from a clean Mac to an Antigravity session that opens on a project already serving at a real URL.
- Install PortBay
- Add your project and press play
- Install the antigravity shim
- Write a card and assign Antigravity
- Move the card and paste the brief
Install PortBay
Homebrew installs the app and the bundled portbay CLI. Prefer a direct download? Grab the DMG from GitHub Releases and drag PortBay.app into Applications.
brew tap portbay-app/portbay && brew install --cask portbayAdd your project and press play
PortBay reads the stack from the folder, issues the certificate, resolves the hostname and attaches a database. Antigravity opens onto a project that is already running, not a cold checkout.
portbay add ~/code/myappInstall the antigravity shim
Downloading Antigravity.app installs a VS Code-style CLI shim named antigravity. That shim is what PortBay calls to open the IDE on a folder, so PortBay finds the agent once the shim is on your PATH.
which antigravityWrite a card and assign Antigravity
Write the brief as you would for any agent — it is going onto your clipboard, not into an argv argument. Assign Antigravity on the card. The card stays a Markdown file in your repo either way.
.portbay/tasks/redesign-order-summary.mdMove the card and paste the brief
PortBay opens Antigravity on the project folder with the card copied. Paste it, work the task in the IDE, and move the card yourself as it progresses — there is no headless run to report back for you.
https://myapp.testWhat an IDE agent cannot do on a board
Worth being blunt about, because the rest of the roster can do all three.
If you want the unattended loop on this project, assign a headless agent to the card instead. If you want Antigravity, this is the honest shape of it.
# a headless agent on this board:# starts unattended when the card lands in To Do# comments what it changed and advances the card itself# runs several at once under a concurrency cap # Antigravity:# opens the IDE, on the folder, with the brief copied# you drive the session and you move the card
The pieces underneath
Agent task board
A Kanban board both you and your agents work. Cards are Markdown in the repo; moving one to To Do dispatches the agent.
Explore →Agent dev environment
Stack detection, runtimes, HTTPS, databases and mail, provisioned per project — the running app your agents verify their work against.
Explore →Asked before downloading
No. Antigravity is an IDE and cannot be driven non-interactively, which PortBay records in the agent's own capabilities rather than working around. CLI mode opens the IDE on the project folder through the antigravity shim; the card's brief rides the clipboard because there is no prompt argument to pass it as.
The board keeps the brief in your repo as Markdown, opens the IDE on a project that is already serving over HTTPS with its database attached, and tracks the card through the same columns, comments and Rejected gate as every other agent. What it does not do is run the work for you.
No. MCP is wired both ways for Claude Code, Codex, Cursor and Gemini only.
Not from PortBay. Antigravity is one of six agents with no wired model flag, so no model selector is offered and nothing is appended to the command.
Give your projects and your agents a real local home.
Download for macOSFree & open source · macOS 11+ on Apple Silicon · Pro from $10/mo