Automated workspace initializer for Google Antigravity and Gemini CLI agents.
ag-init orchestrates the setup of modern Antigravity agent environments:
- Antislop Protection: Installs and configures anti-slop rules via
npx antislop-ai. - AG Kit Core: Merges and installs
.agents/agents, skills, and memory systems viaag-kit init. - Smart Rule Assembly: Deterministically injects and updates opinionated team rules into
AGENTS.mdusing scoped tags. - Workspace Hygiene: Configures
.gitignore(ignoring.ag-init-backups/and.ag-kit-backups/) and ensuresdocs/structure.
Run instantly without installing via uvx or pipx:
uvx ag-initOr run directly from a Git repository:
uvx --from git+https://github.com/Ysn4Irix/ag-init.git ag-initOr target a specific directory:
uvx ag-init --path ./my-new-projectIf Python, uv, and pipx are NOT installed on the system, run this single command to bootstrap everything automatically (no admin/root privileges required):
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/Ysn4Irix/ag-init/main/install.ps1 | iex"macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/Ysn4Irix/ag-init/main/install.sh | sh(This automatically installs standalone uv, which pulls an isolated, sandboxed Python environment on demand without touching system packages).
Install ag-init permanently as a global CLI tool:
# 1. Directly from a Git repository:
uv tool install git+https://github.com/Ysn4Irix/ag-init.git
# or with pipx:
pipx install git+https://github.com/Ysn4Irix/ag-init.git
# 2. Or using the built-in installer:
ag-init install
ag-init install --git https://github.com/Ysn4Irix/ag-init.git
# Install in editable mode from local checkout
ag-init install --editable
# Uninstall
ag-init uninstalluvx ag-init [PATH] [OPTIONS]
Options:
-p, --path PATH Target directory [default: .]
--language-in TEXT Input language directive [default: english]
--language-out TEXT Output language directive [default: english]
--badges / --no-badges Allow or prohibit decorative badges [default: no-badges]
--rules-dir PATH Custom rules directory to include
--exclude, --exclude-package Exclude package: 'antislop-ai', 'ag-kit' (repeatable or comma-separated)
--no-antislop Exclude antislop-ai skills from installation
--no-ag-kit Exclude ag-kit managed .agents tree from installation
--codex Configure workspace for Codex CLI (.codex/ and AGENTS.md)
--skip-upstream Skip running upstream npm/npx tools
--force / -f Non-interactive execution, skip prompts [default: false]
--dry-run Preview operations without writing files [default: false]Configure a project specifically for OpenAI Codex CLI (using .codex/ + AGENTS.md instead of .agents/):
# Initialize project for Codex CLI (.codex/skills/, .codex/agents/, .codex/rules/, AGENTS.md)
uvx ag-init --codex
# Update existing Codex CLI workspace
ag-init update --codexIf you only want Antigravity rules or only specific components, you can exclude individual packages during initialization or update:
# Initialize workspace without antislop-ai skills:
uvx ag-init --exclude antislop-ai
# or with shortcut flag:
uvx ag-init --no-antislop
# Initialize workspace without ag-kit (.agents directory):
uvx ag-init --exclude ag-kit
# or with shortcut flag:
uvx ag-init --no-ag-kit
# Exclude both (initialize only AGENTS.md rules, docs, and git hygiene):
uvx ag-init --exclude antislop-ai,ag-kit# Safely update existing workspace (.agents tree, antislop skills, and AGENTS.md rules)
ag-init update
# Preview workspace update without writing changes
ag-init update --dry-run
# Upgrade the global ag-init tool itself
ag-init update --self# List available and active rules
uvx ag-init rules list
# Add a specific rule to existing project
uvx ag-init rules add <rule-id>
# Re-sync installed rules with latest templates
uvx ag-init rules syncThis project adheres to strict version control and automated release standards:
- CI Matrix: Automated testing on every PR and push across Python 3.10–3.14 on Linux and Windows via GitHub Actions (
.github/workflows/ci.yml). - Versioning: Semantic Versioning (
MAJOR.MINOR.PATCH) with Conventional Commits.feat:bumps MINORfix:,docs:,refactor:,test:bump PATCHBREAKING CHANGE:bumps MAJOR
- Automated Releases: Pushing a tag
v*.*.*automatically triggers.github/workflows/release.yml, building wheels/sdist and publishing a tagged GitHub Release with changelog and build artifacts. - Remote Policy: Changes are committed locally. Pushes or publishing to remotes require explicit authorization.