Overview

Copy Markdown View Source

AntigravityCliSdk

GitHub MIT License

AntigravityCliSdk

AntigravityCliSdk is the supported Google coding-agent SDK for the Antigravity CLI (agy). It gives Elixir applications a typed streaming API, a simple synchronous run/2, governed launch checks, and the runtime module consumed by agent_session_manager for the :antigravity SDK lane.

The retired gemini_cli_sdk is not supported or revived by this package. gemini_ex is a distinct model API SDK and is not a coding-agent CLI runtime.

The SDK does not reimplement subprocess handling. It uses cli_subprocess_core, the same core runtime that powers ASM's common Antigravity lane.

Installation

AntigravityCliSdk 0.2.0 requires Elixir 1.19 or later and cli_subprocess_core ~> 0.4.0.

Sibling checkout during local development:

def deps do
  [
    {:antigravity_cli_sdk, path: "../antigravity_cli_sdk"}
  ]
end

Hex dependency after publish:

def deps do
  [
    {:antigravity_cli_sdk, "~> 0.2.0"}
  ]
end

Quickstart

{:ok, text} =
  AntigravityCliSdk.run("Reply with exactly: OK", %AntigravityCliSdk.Options{
    dangerously_skip_permissions: true
  })

For streaming:

"Explain OTP in one sentence."
|> AntigravityCliSdk.execute(%AntigravityCliSdk.Options{})
|> Enum.each(fn
  %AntigravityCliSdk.Types.MessageEvent{content: text} -> IO.write(text)
  %AntigravityCliSdk.Types.ResultEvent{} -> :ok
  %AntigravityCliSdk.Types.ErrorEvent{} = error -> IO.inspect(error)
end)

Configuration

Runtime configuration is explicit:

  • ANTIGRAVITY_CLI_PATH is translated by config/runtime.exs into the app config key :cli_path.
  • ANTIGRAVITY_MODEL becomes the app config key :model.
  • ANTIGRAVITY_LOG_FILE becomes the app config key :log_file.
  • %AntigravityCliSdk.Options{api_key: value} becomes ANTIGRAVITY_API_KEY in the child process environment.

Library modules read application config, not the parent OS environment.

Three independent timeout controls are available:

  • timeout_ms is the idle wait between stream events;
  • run_deadline_ms is a non-rearming total run ceiling;
  • transport_headless_timeout_ms is the bounded orphan-reap window passed to the Core transport.

completion_only: true and non-nil output_schema are explicit common intents, but Antigravity currently rejects both with AntigravityCliSdk.Error{kind: :unsupported_capability} before resolving or starting agy.

Live Example

mix run examples/simple_stream.exs

The example uses the real agy binary through cli_subprocess_core. Run the full SDK-owned suite with:

~/scripts/with_bash_secrets bash examples/run_all.sh

See Examples for the full inventory. ASM provider examples live in agent_session_manager/examples.

Documentation