Skip to content

docs(readme): refresh Antigravity setup, auth, and CLI usage#310

Open
joycel-github wants to merge 7 commits into
readme-fix-install-harnessfrom
readme-antigravity-sdk-setup
Open

docs(readme): refresh Antigravity setup, auth, and CLI usage#310
joycel-github wants to merge 7 commits into
readme-fix-install-harnessfrom
readme-antigravity-sdk-setup

Conversation

@joycel-github

@joycel-github joycel-github commented Jul 15, 2026

Copy link
Copy Markdown
Collaborator
  • Document the built-in Antigravity harness: local execution needs Python 3 + pip; AX auto-starts the Python sidecar and installs pinned SDK deps on first use.
  • Promote Authentication to its own section (Google AI Studio and Vertex AI/ADC) and earlier on ReadMe
  • Refresh Quick Start / Usage examples - document --harness-config / --harness-config-json, and add a per-request config example. Fix the example that referenced a nonexistent coding harness or wrong wordings

Stacked on #309. Part of #299

- Installation: note local Antigravity needs Python 3 + pip; AX starts the
  Python sidecar and installs pinned SDK deps automatically on first use.
- Promote Authentication to a top-level section covering AI Studio and
  Vertex AI (ADC).
- Quick Start / Usage: use the built-in `antigravity` harness consistently,
  document the `--harness-config` / `--harness-config-json` flags, and add a
  per-request Antigravity configuration example (incl. the /config command).
- Fix the exec example that referenced a nonexistent "coding" harness.
- Move the local Antigravity requirements into a dedicated "Built-in
  Antigravity harness" section and note it is the default harness.
- Simplify Quick Start / Examples to rely on the default harness.
- Restore the "run any registered harness" example.
- Fold the per-request harness-config examples into the Examples block.
- Note that the Quick Start examples omit --harness and assume an ax.yaml
  with a default harness; otherwise pass --harness antigravity explicitly.
- Reword the built-in harness blurb (Antigravity SDK as a reference harness
  implementation) and fix `ax exec` formatting.
Drop the callout block and clarify inline that the Quick Start examples
rely on the default ax.yaml which runs the built-in Antigravity harness.
- Trim the built-in harness blurb and drop a trailing space.
- Clarify the Quick Start example uses the checked-in ax.yaml that sets
  Antigravity as the default harness.
- Fix the "# To keep the same JSON in a file" comment spacing.
@joycel-github joycel-github force-pushed the readme-antigravity-sdk-setup branch from 0c886f7 to a18945c Compare July 15, 2026 05:16
@joycel-github joycel-github changed the base branch from main to readme-fix-install-harness July 15, 2026 05:16
The prior wording ("requires Python 3 with pip" next to "installs
automatically") read as a contradiction. Make explicit that python3/pip
are the only prerequisite and AX installs the pinned SDK dependencies for
the user on first `ax exec`.
Show `--harness antigravity` explicitly in the "specific harness" example
and shorten the per-request harness-config comment.
@joycel-github joycel-github marked this pull request as ready for review July 15, 2026 05:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant