🪐 Google Antigravity Workspace Template

Production-grade starter kit for autonomous AI agents on Google Antigravity.

Language: English | 中文（仓库主页） | 中文文档 | Español

🌟 Project Intent

In a world full of AI IDEs, I want enterprise-grade architecture to be as simple as Clone → Rename → Prompt.

This project leverages IDE context awareness (via .cursorrules and .antigravity/rules.md) to pre-embed a complete cognitive architecture in the repo.

When you open this project, your IDE stops being just an editor—it becomes an industry-savvy architect.

First principles:

• Minimize repetition: the repo should encode defaults so setup is nearly zero.
• Make intent explicit: capture architecture, context, and workflows in files, not tribal knowledge.
• Treat the IDE as a teammate: contextual rules turn the editor into a proactive architect, not a passive tool.

Why do we need a thinking scaffold?

While building with Google Antigravity or Cursor, I found a pain point:

The IDE and models are powerful, but the empty project is too weak.

Every new project repeats the same boring setup:

• "Should my code live in src or app?"
• "How do I define utilities so Gemini recognizes them?"
• "How do I help the AI remember prior context?"

This repetition wastes creative energy. My ideal workflow is: after a git clone, the IDE already knows what to do.

So I built this project: Antigravity Workspace Template.

⚡ Quick Start

Automated Installation (Recommended)

Linux / macOS:

# 1. Clone the template
git clone https://github.com/study8677/antigravity-workspace-template.git my-project
cd my-project

# 2. Run the installer
chmod +x install.sh
./install.sh

# 3. Configure your API keys
nano .env

# 4. Run the agent
source venv/bin/activate
python src/agent.py

Windows:

# 1. Clone the template
git clone https://github.com/study8677/antigravity-workspace-template.git my-project
cd my-project

# 2. Run the installer
install.bat

# 3. Configure your API keys (notepad .env)

# 4. Run the agent
python src/agent.py

Manual Installation

# 1. Clone the template
git clone https://github.com/study8677/antigravity-workspace-template.git my-project
cd my-project

# 2. Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Configure your API keys
cp .env.example .env  # (if available) or create .env manually
nano .env

# 5. Run the agent
python src/agent.py

That's it! The IDE auto-loads configuration via .cursorrules + .antigravity/rules.md. You're ready to prompt.

🎯 What Is This?

This is not another LangChain wrapper. It's a minimal, transparent workspace for building AI agents that:

• 🧠 Have infinite memory (recursive summarization)
• 🛠️ Auto-discover tools from src/tools/
• 📚 Auto-inject context from .context/
• 🔌 Connect to MCP servers seamlessly
• 🤖 Coordinate multiple specialist agents
• 📦 Save outputs as artifacts (plans, logs, evidence)

Clone → Rename → Prompt. That's the workflow.

🚀 Key Features

Feature	Description
🧠 Infinite Memory	Recursive summarization compresses context automatically
🛠️ Universal Tools	Drop Python functions in src/tools/ → auto-discovered
📚 Auto Context	Add files to .context/ → auto-injected into prompts
🔌 MCP Support	Connect GitHub, databases, filesystems, custom servers
🤖 Swarm Agents	Multi-agent orchestration with Router-Worker pattern
⚡ Gemini Native	Optimized for Gemini 2.0 Flash
🌐 LLM Agnostic	Use OpenAI, Azure, Ollama, or any OpenAI-compatible API
📂 Artifact-First	Every task produces plans, logs, and evidence

📚 Documentation

Full documentation available in /docs/en/:

• Quick Start — Installation & deployment
• Philosophy — Core concepts & architecture
• Zero-Config — Auto tool & context loading
• MCP Integration — External tool connectivity
• Swarm Protocol — Multi-agent coordination
• Roadmap — Future phases & vision

🏗️ Project Structure

src/
├── agent.py           # Main agent loop
├── memory.py          # JSON memory manager
├── mcp_client.py      # MCP integration
├── swarm.py           # Multi-agent orchestration
├── agents/            # Specialist agents
└── tools/             # Your custom tools

.context/             # Knowledge base (auto-injected)
.antigravity/         # Antigravity rules
artifacts/            # Outputs & evidence

💡 Example: Build a Tool in 30 Seconds

# src/tools/my_tool.py
def analyze_sentiment(text: str) -> str:
    """Analyzes the sentiment of given text."""
    return "positive" if len(text) > 10 else "neutral"

Restart agent. Done! The tool is now available.

🔌 MCP Integration

Connect to external tools:

{
  "servers": [
    {
      "name": "github",
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "enabled": true
    }
  ]
}

Agent automatically discovers and uses all MCP tools.

🤖 Multi-Agent Swarm

Decompose complex tasks:

from src.swarm import SwarmOrchestrator

swarm = SwarmOrchestrator()
result = swarm.execute("Build and review a calculator")

The swarm automatically:

• 📤 Routes to Coder, Reviewer, Researcher agents
• 🧩 Synthesizes results
• 📂 Saves artifacts

✅ What's Complete

• ✅ Phase 1-7: Foundation, DevOps, Memory, Tools, Swarm, Discovery
• ✅ Phase 8: MCP Integration (fully implemented)
• 🚀 Phase 9: Enterprise Core (in progress)

🆕 Recent Updates

• Added local OpenAI-compatible backend support (e.g., Ollama) when no Google API key is provided.
• Fixed .env loading so runs from the src/ folder still read the project-root config.
• Default .env now points to local backend placeholders instead of a hardcoded Google key.
• CLI entrypoints (agent.py and src/agent.py) now accept tasks via arguments or AGENT_TASK, instead of a fixed demo task.

See Roadmap for details.

🤝 Contributing

Ideas are contributions too! Open an issue to:

• Report bugs
• Suggest features
• Propose architecture (Phase 9)

Or submit a PR to improve docs or code.

👥 Contributors

• @devalexanderdaza — First contributor. Implemented demo tools, enhanced agent functionality, proposed the "Agent OS" roadmap, and completed MCP integration.
• @Subham-KRLX — Added dynamic tools and context loading (Fixes #4) and the multi-agent cluster protocol (Fixes #6).

⭐ Star History

📄 License

MIT License. See LICENSE for details.

---

Explore Full Documentation →