PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

1.0.0

PyPI

agypywpr

Run Antigravity CLI tasks with temporary permission augmentation.

Published20 Sept 2026
Direct dependencies3
Transitive dependenciesNot calculated

README

Version 1.0.0 documentation

agypywpr

agypywpr runs a one-shot Google Antigravity CLI task with temporary permission rules. It backs up ~/.gemini/antigravity-cli/settings.json, augments the permission lists, runs agy, and restores the original settings afterward.

Installation

Antigravity CLI must already be installed and authenticated as agy.

python3 -m pip install agypywpr

Run a prompt from a UTF-8 file:

agypywpr run prompt.txt --permissions-file permissions.json

Arguments after -- are passed to agy:

agypywpr run prompt.txt -- --model gemini

The default timeout is 30 minutes. Use --timeout SECONDS to override it.

Permission file

The permission file contains an additive fragment. Existing settings are not replaced.

{
  "permissions": {
    "allow": ["command(git)", "write_file(src/)"],
    "deny": ["command(sudo)"],
    "ask": ["command(*)"]
  }
}

Rules are deduplicated within each list. Antigravity evaluates conflicting rules using its documented precedence: deny, then ask, then allow.

Recovery

The wrapper uses a lock, a mode-0600 recovery journal, and atomic settings writes. If the process is forcibly killed, inspect the settings and run:

agypywpr restore

The current release targets Linux and macOS. The completion behavior for background Antigravity subagents is under compatibility testing because AGY's headless completion protocol is not documented.

Development

.venv/bin/python -m pip install --editable '.[dev]'
.venv/bin/python -m unittest discover -s tests -v

Build the wheel and source distribution from the repository root:

.venv/bin/python -m build

Publishing

Releases are published from GitHub through PyPI Trusted Publishing (OIDC). Configure a protected pypi GitHub Environment and register the repository's pending Trusted Publisher on PyPI before creating a release tag.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 3

Native requirements
3 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
pytest>=8; extra == "dev"runtime
pylint
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
pylint>=3; extra == "dev"runtime
build
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
build>=1.2; extra == "dev"runtime

Distribution files

2 collected
agypywpr-1.0.0-py3-none-any.whl

bdist_wheel · 9.76 KB · Python py3

Source file
agypywpr-1.0.0.tar.gz

sdist · 12.83 KB · Python source

Source file

Metadata history

Meaningful changes
Current collected state Current

Observed since 21 Oct, 09:34 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:1cfe0b02a4b07a33c4bc093c6a3b5cc19a0c85234c131729efeba930ca2861b2

Other collected versions

View all collected versions →