← Back to archive

Repo of the Day

zjshen14/agy-hq

Published: Nov 16, 2026

Open repository ↗

Lightweight, proactive Personal Agent OS for Google Antigravity

Summary

agy-hq is a lightweight, local-first Personal Agent OS that plugs into Google Antigravity on macOS or Linux. It separates the public Go engine from a git-ignored private vault while adding delegated worktrees, proactive inbox handling, persistent memory, and approval-gated outbound actions.

What it is useful for

The project targets engineers who want Antigravity to handle ongoing assistant work without blocking their primary chat. A pinned [HQ] Front Desk handles quick requests, while deeper coding or research can be delegated into isolated Git worktrees under local/worktrees/.

Concrete workflows include triaging a PDF, CSV, or filing dropped into local/inbox/, reviewing a morning brief, tracking a task’s “waiting on” SLA, or staging a Google Chat or email action for review rather than sending it immediately.

The private vault contains profiles, notes, journals, memory topics, entity dossiers, drafts, and credentials under local/. Background launchd or systemd timers perform cursor checks and route changes through interrupt, brief-rollup, ideas-feed, and silent-ledger channels. Outbound proposals carry a TTL and SHA-256 approval prefix, while hooks block direct outbound mutations and raw credential reads. Memory commands can look up, verify, add, or forget information across the vault.

How engineers can use it

The README lists macOS or Linux, the Google Antigravity desktop app, Git, and Go 1.22+ as prerequisites. To explore the interface with synthetic data, run:

git clone https://github.com/zjshen14/agy-hq.git headquarter
cd headquarter
./scripts/bootstrap.sh --demo

This compiles bin/hq, initializes the git-ignored vault, installs hooks and a background daemon, and runs a doctor check. For a clean, project-scoped installation, use ./scripts/bootstrap.sh; use ./scripts/bootstrap.sh --global to install the plugin across Antigravity workspaces.

After setup, check the installation with ./bin/hq status or ./bin/hq doctor, and open the local console with ./bin/hq webui. A practical workflow is to add optional starter skills with ./bin/hq skill add <name|--all>, place files in local/inbox/, inspect work with ./bin/hq tasks, create isolated checkouts with ./bin/hq worktree add <repo> <task>, and review pending outbound proposals before approving them.

Inbox triage and message-reading workflows operate under quarantine restrictions, intentionally blocking web egress, file writes, or private-vault reads during those sessions. Consult docs/README.md for architecture, RFCs, setup details, and documented constraints.