agy-p is a tiny npx wrapper for google antigravity cli print mode. it runs the real agy binary with --print, forwards stdio and exit codes, and keeps the package-manager surface short.

the repository is named antigravity-p; the npm package and executable are named agy-p.

quickstart

install antigravity cli first:

curl -fsSL https://antigravity.google/cli/install.sh | bash

then run:

npx agy-p "summarize this repository"

or install globally:

npm install -g agy-p
agy-p "find risky todos"

why

claude-p needs a pty and hook harness because it emulates a print mode by driving an interactive tui. antigravity cli already ships native print mode, so antigravity-p deliberately stays smaller:

• inject agy --print
• pass antigravity flags before print mode
• join positional prompt tokens into the single prompt value agy expects
• preserve stdin, stdout, stderr, cwd, env, and exit codes
• avoid writing antigravity config or adding hook shims

examples

npx agy-p "reply with exactly: hello"
npx agy-p --timeout 900 "run tests and explain failures"
npx agy-p --sandbox "audit src for race conditions"
npx agy-p --add-dir ../shared "refactor this package"
npx agy-p -- "-- this prompt starts with dashes"

use AGY_P_AGY_PATH or --agy-path when agy is not on PATH.

AGY_P_AGY_PATH="$HOME/.local/bin/agy" npx agy-p "explain package.json"

flags

--timeout <seconds>       maps to agy --print-timeout <seconds>s
--agy-path <path>         uses a specific agy binary
-h, --help                prints help
-v, --version             prints version
--                        ends agy-p option parsing; remaining tokens become prompt text

dash-prefixed antigravity flags are forwarded to agy before --print. positional tokens are joined into the single prompt argument that agy --print expects.

agy-p rejects -p, --print, --prompt, -i, and --prompt-interactive because the wrapper owns print-mode selection.

development

npm test
npm run lint
npm pack --dry-run

the test suite uses node's built-in test runner and a real temporary executable as the child process. live smoke testing also passed against authenticated antigravity cli 1.0.1.

ci and release

ci runs on pushes and pull requests.

release publishing runs on v* tags and publishes agy-p to npm with provenance when NPM_TOKEN is configured in repository secrets.

license

released under the mit license.