Universal AI Context Generator & Workflow CLI for Cursor, Windsurf, and Antigravity.
npm install antigravity-flowag-flow) is a CLI tool originally built to prepare projects for Google Antigravity. It has since evolved into a universal context generator that standardizes development workflows for all AI-native IDEs, including Cursor, Windsurf, Gemini Code Assist, and GitHub Copilot.
any, mandatory docs.
// TODO debt, optional TDD.
.agent/project-context.md to prime your AI agent.
.cursor/rules/*.mdc)
.windsurfrules, .windsurf/rules/)
.gemini/settings.json)
ag-flow templates to eject and modify any internal template.
.agent/antigravity.json.
bash
npm install -g antigravity-flow
Or run without installing:
npx antigravity-flow init
`
``
🔄 Updating
To update to the latest version:
`bash
npm update -g antigravity-flow
``
🚀 Usage
Navigate to your project root and run:
`bash
ag-flow init
or with configuration file (Non-interactive):
ag-flow init --config ./antigravity.json
or
npx antigravity-flow init
`
To view the comprehensive user guide directly in your terminal:
`bash
ag-flow guide
or for French:
ag-flow guide fr
`
$3
You can view and customize any internal template (prompts, rules, Dockerfiles):
`bash
List all available templates
ag-flow templates list
Eject and edit a template (opens system editor)
ag-flow templates update docker/django.Dockerfile.ejs
`
The CLI will automatically prioritize your local templates in .agent/templates/.
$3
The CLI will guide you through:
1. Language: English (en) or French (fr).
2. Project Description: Brief overview of your project.
3. Tech Stack:
- Frontend, Backend, Mobile, Smart Contracts
4. Database & ORM: PostgreSQL, MySQL, SQL Server, Oracle, MongoDB, etc.
5. Architecture: Hexagonal, Clean, MVC, Feature-Sliced, Microservices.
6. Rigor Mode: Strict, Standard, Prototype, Legacy.
7. Version Control: GitHub, GitLab, Azure DevOps, Bitbucket.
8. Branching Strategy: GitFlow, GitHub Flow, Trunk-Based.
9. Package Manager: npm, yarn, pnpm, bun, pip, poetry, cargo, etc.
10. Testing Framework: Jest, Vitest, Playwright, Cypress, pytest, etc.
11. Deployment Platform: Vercel, Netlify, AWS, Azure, GCP, Railway, etc.
12. Security Scanning: Snyk, Dependabot, Renovate, SonarQube.
13. Monorepo: Turborepo, Nx, Lerna, pnpm/yarn workspaces.
14. Roles: Select which workflows to generate.
15. IDE Integration: Cursor, Windsurf, Gemini, Copilot.
📂 Output Structure
`
.
├── .github/workflows/
│ └── ci.yml # Generated CI/CD pipeline
├── .agent/
│ ├── workflows/ # Role-specific prompt templates
│ │ ├── dev.md # Developer workflow
│ │ ├── qa.md # QA workflow
│ │ ├── architect.md # Architect workflow
│ │ ├── devops.md # DevOps workflow (NEW)
│ │ ├── security.md # Security Engineer (NEW)
│ │ ├── techwriter.md # Tech Writer (NEW)
│ │ └── data.md # Data Engineer (NEW)
│ ├── rules/
│ │ └── coding-standards.md # Dynamic rules based on stack & rigor
│ ├── project-context.md # High-level context for AI
│ └── antigravity.json # Persisted configuration
├── .cursor/rules/ # Cursor IDE rules (if selected)
├── .windsurf/rules/ # Windsurf IDE rules (if selected)
└── .gemini/settings.json # Gemini Code Assist (if selected)
``