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)
``