💎 Antigravity Ruby SDK

agent = Antigravity::Agent.new(
  skills: ["./skills/code-quality-review"],
  workspace: "."
)

agent.ask("Review this codebase for best practices") { |chunk| print chunk.content }

💎irb> config                   # full session state (api_key masked!)
💎irb> cd '~/git/my-project'    # change workspace (validated)
💎irb> set_policy :turbo        # switch safety policy
💎irb> @agent.class             # => Antigravity::Agent
💎irb> exit                     # "Welcome... to the real world, Neo. 🕶️"

agent = Antigravity::Agent.new(
  # Mix local and remote skills in the constructor
  skills: [
    "./skills/code-quality-review",                           # Local
    "https://github.com/gemini-cli-extensions/sre",           # GitHub (auto-clones all 16 skills!)
  ]
)

# Add a specific skill from a GitHub repo
agent.add_skill("https://github.com/gemini-cli-extensions/sre", skill_name: "skills/postmortem-generator")

# Define a skill inline (no file needed)
agent.add_inline_skill(
  name: "emoji-formatter",
  description: "Formats output with emoji severity markers",
  instructions: "Use: CRITICAL: 🚨, HIGH: 🔴, MEDIUM: 🟡, LOW: 🔵, PASSED: ✅"
)

# Discover skills in a folder
Agent.list_skills("~/git/skillume/sre-extension/")
# => ["/path/to/anomaly-detection", "/path/to/cloud-logging", ...]

agent = Antigravity::Agent.new(workspace: "~/git/my-project")
agent.connect!
agent.ask("What tech stack does this project use?") { |c| print c.content }
agent.close!

agent = Antigravity::Agent.new  # Logging just works!
# => 🪵 Logging to log/antigravity.jsonl

agent = Antigravity::Agent.new do |a|
  a.system_instruction = "You are a helpful Ruby assistant."
  a.attach_sidecar(Antigravity::Sidecar::AuditLogger.new("log/audit.jsonl"))
  a.before_tool_call(&Antigravity::Guards::FileProtection.new)
  a.after_tool_call(&Antigravity::Guards::SecretMasker.new)
end

agent = Antigravity::Agent.new(policy: :default)   # Use a preset
agent = Antigravity::Agent.new(policy: :cautious)   # Locked down for prod
agent = Antigravity::Agent.new(policy: :turbo)      # Wide open for dev
agent = Antigravity::Agent.new(policy: :auto)       # Picks from RAILS_ENV!

policy = Antigravity::Policy.define do
  deny_all
  allow :view_file
  allow :grep_search
  allow :run_command, when: cmd('echo', 'git status', 'bundle exec rspec')
  allow :write_to_file
  deny  :write_to_file, when: path('.env', '*.key', '*.pem')
  deny  :run_command,   when: cmd('rm', 'git reset --hard')
end

agent = Antigravity::Agent.new(policy: policy)

# Order A                           # Order B
Policy.define do                    Policy.define do
  allow :run_command                  deny :run_command, when: cmd('rm')
  deny :run_command,                  allow :run_command
    when: cmd('rm')                 end
end

# In production — this works!
agent.hooks.run_pre_tool(:write_to_file, path: 'scratch/debug.log', content: '...')
# => { allowed: true }

# But this is blocked:
agent.hooks.run_pre_tool(:write_to_file, path: 'app.rb', content: '...')
# => { allowed: false, reason: "Denied by policy" }