gemini-init

Bootstrap a production-ready AI agent context into any project in under 60 seconds.

npx gemini-init

What It Does

gemini-init drops a complete AI agent system into your project:

| What gets installed | Purpose | | :--- | :--- | | GEMINI.md | The AI's brain — persistent context, behavior rules, Known Traps | | .agent/workflows/ | 18 standardized procedures (/feature, /debug, /review, etc.) | | .agent/skills/ | 20 specialized AI behaviors (debugging, security, accessibility, etc.) | | .agent/session.md | Persistent work log — AI reads this at the start of every session | | docs/ | Architecture, API, conventions, and feature spec templates | | .env.example | Pre-structured environment variable template | | CHANGELOG.md | Ready for /release workflow | | .github/workflows/ai-check.yml | CI check that validates AI context on every PR |

The AI maintains all documentation automatically. You only provide business intent.

Quick Start

# Standard install (interactive wizard)
npx gemini-init

# Use a pre-filled stack preset
npx gemini-init --preset=nextjs
npx gemini-init --preset=android-kotlin
npx gemini-init --preset=python-fastapi
npx gemini-init --preset=node-express

# Preview what would be installed (no files written)
npx gemini-init --dry-run

# Upgrade .agent/ skills and workflows (never touches GEMINI.md or docs/)
npx gemini-init --upgrade

Project Detection Matrix

gemini-init detects your project state and adjusts accordingly:

| | Single Repo | Monorepo | | :--- | :--- | :--- | | Fresh Project | Drops all files, prints setup checklist, suggests /setup | Drops root files + per-package GEMINI.md stubs | | Ongoing Project | Smart overwrite prompts, suggests /adopt to auto-fill docs | Same + per-package stubs for any new packages |

After Install — Next Steps

Fresh Project:

1. Fill in the [FILL IN] sections of GEMINI.md (or let the AI do it)
2. Open Antigravity IDE and type: /setup
3. Type: /flight-check
4. Start building: "I want to build <feature name>"

Ongoing Project:

1. Open Antigravity IDE and type: /adopt
2. Review GEMINI.md and add any project-specific Known Traps
3. Type: /flight-check
4. Continue where you left off

The 18 Workflows

| Category | Commands | | :--- | :--- | | Lifecycle | /setup, /adopt, /flight-check, /onboard | | Features | /spec <name>, /feature <name> | | Quality | /debug <desc>, /review, /review --delta, /test, /audit | | Maintenance | /cleanup, /document <file>, /dependency-update, /migrate | | Release | /release, /hotfix <desc>, /rollback, /deploy <env> |

License

MIT