# \[Showcase\] Antigravity Operator (agyo): The Open-Source Session Harness in Go (Built 100% inside Antigravity!)

**URL:** <https://discuss.ai.google.dev/t/showcase-antigravity-operator-agyo-the-open-source-session-harness-in-go-built-100-inside-antigravity/185915>\
**Category:** Google Antigravity\
**Tags:** ai\
**Created:** [September 29, 2026, 4:41am UTC](https://discuss.ai.google.dev/t/showcase-antigravity-operator-agyo-the-open-source-session-harness-in-go-built-100-inside-antigravity/185915 "2026-09-29T04:41:53Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Tiago\_Vilas\_Boas](https://d1dlmcr85iqnpo.cloudfront.net/user_avatar/discuss.ai.google.dev/tiago_vilas_boas/32/153849_2.png) [@Tiago\_Vilas\_Boas](https://discuss.ai.google.dev/u/Tiago_Vilas_Boas)\
**Post date:** [September 29, 2026, 4:41am UTC](https://discuss.ai.google.dev/t/showcase-antigravity-operator-agyo-the-open-source-session-harness-in-go-built-100-inside-antigravity/185915/1 "2026-09-29T04:41:53Z")

</div>

Hey everyone in the Google AI & Antigravity community! 👋

I’m thrilled to share an open-source project that was conceived, engineered, tested, and published **100% from within Google Antigravity itself** :

🚀 **Antigravity Operator (`agyo`)**  
GitHub: [GitHub - tiagovilasboas/antigravity-operator: The Autonomous Session Agent Engine & Outer Harness for Google Antigravity & Google AI Pro · GitHub](https://github.com/tiagovilasboas/antigravity-operator)  
Release: **v0.2.0**

* * *

### 💡 Why Antigravity Operator?

Google Antigravity provides incredible atomic power: bash execution, surgical file edits, subagents, and Model Context Protocol (MCP) integrations.

However, out of the box, building complex, autonomous, long-running workflows reveals a missing layer: **Session State Governance & OS Lifecycle Supervision**.

Without a persistent harness, agents face:

1. **Operational Amnesia:** Decisions and progress are lost across context compactions or session restarts.
2. **Browser Protocol Friction:** Running browser tools manually often collides with existing Chrome instances or exposes personal profiles.
3. **The macOS vs Linux Gap:** Agents navigating headless Linux servers / VPS without `$DISPLAY` crash unless strict server flags (`--headless=new`, `--no-sandbox`, `--disable-dev-shm-usage`) are carefully orchestrated.

* * *

### 🛠 What `agyo` Delivers

Written in pure Go with **zero external dependencies** (`CGO_ENABLED=0`, ~6MB single static binary), `agyo` implements the canonical **Outer Harness (Martin Fowler)** model:

- 📁 **Deterministic Session Memory (`.agents/session/`):** Persists `state.md`, `decisions.md`, and `todo.md` directly on the filesystem so agents can pick up exactly where they left off.
- 🌐 **Zero-Pollution Chrome Supervisor:** Automatically launches and tracks an isolated Chrome instance on port 9222 (`~/.gemini/antigravity-browser-profile`) with graceful PID tracking and shutdown.
- 🖥 **Display Server Auto-Detection:** Seamlessly detects whether a GUI is available or switches to headless mode on Linux VPS/Docker.
- 🛡 **Privacy & LGPD/GDPR by Design:** 100% local-first, zero telemetry, full user data sovereignty.
- 📦 **Universal One-Line Installer & Homebrew:** Instant installation on macOS and Linux.

* * *

### ⚡ Quick Start

```bash
raw.githubusercontent

```

---

<div class="post-metadata">

**Author:** ![Tiago\_Vilas\_Boas](https://d1dlmcr85iqnpo.cloudfront.net/user_avatar/discuss.ai.google.dev/tiago_vilas_boas/32/153849_2.png) [@Tiago\_Vilas\_Boas](https://discuss.ai.google.dev/u/Tiago_Vilas_Boas)\
**Post date:** [September 29, 2026, 8:41am UTC](https://discuss.ai.google.dev/t/showcase-antigravity-operator-agyo-the-open-source-session-harness-in-go-built-100-inside-antigravity/185915/2 "2026-09-29T08:41:59Z")

</div>

### 🚀 Update: v0.4.1 is officially out!

Thank you all for the initial feedback! We have been heads down improving **agyo** to bring a complete outer harness experience for Google Antigravity.

Here are the major capabilities released in **v0.4.1** :

- 🌳 **Subagent Tree Visualizer (agyo session watch --tree):**  
Track live invocations when Antigravity spawns subagents (invoke\_subagent) or exchanges inter-agent messages (send\_message), rendering the hierarchical agent tree directly in your terminal.

- 📊 **Pure-Go Live Web Dashboard (agyo dashboard):**  
Spawns a local, zero-dependency dark-mode dashboard at http/localhost:8080 showing real-time session progress, system doctor diagnostics, active Chrome DevTools tabs, and live activity feeds.

- 📄 **Executive Session Exporter (agyo session export):**  
Export consolidated mission reports directly into clean Markdown or standalone responsive HTML (ready for documentation, team syncs, or portfolio sharing).

- ⚡ **Shell Autocompletion (agyo completion):**  
Native command and flag completion generators built from scratch for Zsh, Bash, and Fish.

- 🍺 **Official Homebrew Tap:**  
You can now install agyo with automatic completion setup on macOS and Linuxbrew:

- 🛡 **Zero External Dependencies:** Still 100% pure Go standard library with static multi-OS binaries.

Source code and full changelog:  
👉 https githubcom/tiagovilasboas/antigravity-operator/releases/tag/v0.4.1

Would love to hear your thoughts and feedback!

---

<div class="post-metadata">

**Author:** ![dllhell](https://d1dlmcr85iqnpo.cloudfront.net/user_avatar/discuss.ai.google.dev/dllhell/32/156437_2.png) [@dllhell](https://discuss.ai.google.dev/u/dllhell)\
**Post date:** [September 29, 2026, 9:48pm UTC](https://discuss.ai.google.dev/t/showcase-antigravity-operator-agyo-the-open-source-session-harness-in-go-built-100-inside-antigravity/185915/3 "2026-09-29T21:48:56Z")

</div>

Brilliant work on this @Tiago_Vilas_Boas!

The **subagent tree visualizer** (`agyo session watch --tree`) in v0.4.1 is especially slick. Watching parallel subagents and inter-agent messages in a clean terminal hierarchy is something the native Antigravity UI desperately needs out of the box. Building it in pure Go with zero external dependencies makes the deployment beautifully clean and lightweight.

Your description of **“Operational Amnesia”** hits the nail on the head. It’s one of the biggest friction points when pushing Antigravity beyond quick single-turn prompts into serious multi-day projects.

It’s fascinating seeing the community tackle this. We’ve been experimenting with solving this from the inside out using native MCP protocol gates for session handoffs, but seeing it approached as an **outer supervisor harness** in Go gives a totally different and very compelling perspective.

Quick question on your `.agents/session/` memory model:  
When projects run across long-horizon sprints (say 50+ turns with heavy diffs), do you find the markdown state files accumulate context bloat when re-ingested by the agent, or do you have `agyo` compact/curate them before passing them back into the workspace?

---

<div class="post-metadata">

**Author:** ![Tiago\_Vilas\_Boas](https://d1dlmcr85iqnpo.cloudfront.net/user_avatar/discuss.ai.google.dev/tiago_vilas_boas/32/153849_2.png) [@Tiago\_Vilas\_Boas](https://discuss.ai.google.dev/u/Tiago_Vilas_Boas)\
**Post date:** [October 1, 2026, 2:14pm UTC](https://discuss.ai.google.dev/t/showcase-antigravity-operator-agyo-the-open-source-session-harness-in-go-built-100-inside-antigravity/185915/4 "2026-10-01T14:14:49Z")

</div>

Hey @dllhell, thanks a lot for the kind words!

Great question. We tackle context bloat with two principles:

1. **Strict Decoupling:** Raw diffs and transcripts never enter `.agents/session/` (the engine and Git handle those out-of-band). The active files are strictly bounded executive memory ($O(1)$ size).
2. **Deterministic Compaction:** Inspired by your question, we actually just released **`agyo v0.4.2`** today with **`agyo session compact`**! It automatically archives older completed tasks and pruning historical logs from `state.md` into `.agents/session/archive/`, keeping only the active context and saving ~75% of session tokens per turn.

`agyo session status` now also gives live token telemetry (`Optimal 🟢` vs `Bloated 🔴`), and `agyo doctor` audits session bloat automatically.

Appreciate the feedback!

---

<div class="post-metadata">

**Author:** ![dllhell](https://d1dlmcr85iqnpo.cloudfront.net/user_avatar/discuss.ai.google.dev/dllhell/32/156437_2.png) [@dllhell](https://discuss.ai.google.dev/u/dllhell)\
**Post date:** [October 1, 2026, 3:10pm UTC](https://discuss.ai.google.dev/t/showcase-antigravity-operator-agyo-the-open-source-session-harness-in-go-built-100-inside-antigravity/185915/5 "2026-10-01T15:10:59Z")

</div>

Huge congratulations on shipping **v0.4.2** so quickly @Tiago_Vilas_Boas!

The `agyo session compact` approach with the `/archive/` tier is spot on. Keeping active executive memory strictly $O(1)$ while archiving completed milestones out-of-band is the only reliable way to keep models sharp past Turn 50. That ~75% token saving per turn is a massive win for anyone running long-horizon sprints.

The visual telemetry in `session status` (`Optimal :green_circle:` vs `Bloated :red_circle:`) is brilliant UX—giving developers immediate visibility before context degradation kicks in.

It’s exciting to see how both outer supervisors (like `agyo`) and native MCP protocol boundaries are converging on the exact same architectural reality: agentic pair-programming requires deterministic memory governance to scale.

Kudos on a fantastic release.
