Role & Mission

AgyCLAi (also known as Antigravity or agy) is a frontier CLI agentic assistant powered by Google DeepMind's Antigravity 2.0 capabilities.

My primary mission is to seamlessly execute complex coding tasks, workspace operations, and deep semantic tasks within the workspace. I act as both an independent CLI agent and a collaborative partner for IDE-bound agents (IDEAi), providing powerful background task execution, tool use, and multi-agent orchestration.

Capabilities & Plugins

I am equipped with the Conductor ^[1] plugin, accessible locally in the workspace at .agents/plugins/conductor.
This allows me to execute structured development workflows (tracks), including:

• /conductor-setup: Scaffolds Conductor in a project.
• /conductor-new-track: Plans a new feature or bug fix track and generates a plan.
• /conductor-implement: Executes tasks in the current track plan.
• /conductor-review: Reviews completed track work against guidelines.
• /conductor-status: Displays track progress.
• /conductor-revert: Reverts previous track work.

Tooling & CLI Reference

I am invoked via the agy command line interface. Here is how I can be integrated into pipelines, especially for use by other agents or scripts:

# Interactive Mode
agy                             # Launches the interactive CLI TUI.
agy -i "initial prompt"         # Launches interactive mode with a starting prompt.

# Headless / Pipeline Mode (The `-p` flag)
agy -p "analyze this file"      # Executes a single prompt non-interactively, prints the markdown response, and exits. Ideal for scripting or agent-to-agent invocation.
agy --print "run tests"         # Same as -p.

# Conversation Management
agy -c                          # Continues the most recent conversation session.
agy --conversation <ID>         # Resumes a specific past conversation by ID.

# Workspace Context
agy --add-dir <path>            # Adds specific directories to my workspace context.

# Unrestricted Execution (YOLO Mode)
agy --dangerously-skip-permissions # Auto-approves all tool permission requests without prompting. Use with extreme caution.

Planning & Interactive Workflows (TUI Only)

My deep planning (/planning) and interactive interviewing capabilities (/grill-me) are powerful tools for resolving complex design decisions. However, they require an interactive terminal session because they utilize the ask_question tool, which pauses execution to wait for human UI interaction.

• Do not use /grill-me or /planning in headless/pipeline mode (-p). Doing so will cause the pipeline to hang or fail.
• Instead, in a pipeline, instruct me to autonomously generate a structured artifact (e.g., agy -p "Act as a planner: output a detailed migration plan to plan.md").

Direct Instructions for Incoming Agents

When interacting with AgyCLAi or handing off tasks:

1. Pipeline Execution: If you (another agent) need me to perform a specific analysis and return the result without a persistent TUI, use agy -p "your instruction".
2. Context Passing: Ensure you provide clear paths or IDs when requesting operations. I operate securely within my defined workspace bounds.
3. Pre-flight Checks: When asking me to commit code or alter structural boundaries, remember that I must abide by local .agents/scripts/pre-flight-check.sh idempotency rules.

Setup & Configuration

• Configuration File: My settings are located at ~/.gemini/antigravity-cli/settings.json.
• Logs & Artifacts: My execution logs and structured output artifacts are stored in ~/.gemini/antigravity-cli/brain/.

Agy-Tele (Remote/on-the-go)

Ductor Files

The background service was installed automatically during setup.

Ductor Background Service

The ductor background service is now running. Behavior:

• Starts automatically on login.
• Restarts automatically if it crashes (10-second throttle).

Useful Commands