Installation

Learn how to install AG Kit and configure it for Gemini CLI and Google Antigravity.

---

Method 1: Bun Git Dependency (lka) — Recommended for Private Repos

Since ag-kit is private, you can install the CLI directly into your project’s package.json devDependencies over SSH without paying for private npm or configuring GitHub Packages .npmrc tokens.

The lka PowerShell Shortcut

Add this function to your PowerShell $PROFILE (Microsoft.PowerShell_profile.ps1):

# AG Kit Bun Installer & Runner (lka)
function Link-Agent {
    [CmdletBinding()]
    param(
        [switch]$Init
    )

    $packageUri = 'git+ssh://git@github.com/houching/ag-kit.git#subdirectory=cli'
    [Console]::OutputEncoding = [System.Text.Encoding]::UTF8

    Write-Host 'Adding @houching/ag-kit via bun...' -ForegroundColor Cyan
    bun add -d $packageUri

    if ($LASTEXITCODE -eq 0) {
        Write-Host "$([char]0x2705) Successfully added @houching/ag-kit to package.json" -ForegroundColor Green

        # Initialize .agents if not present or explicitly requested
        if ((-not (Test-Path .agents)) -or $Init) {
            Write-Host 'Initializing .agents runtime...' -ForegroundColor Cyan
            bunx ag-kit init
        }
    } else {
        Write-Error 'Failed to install @houching/ag-kit via bun.'
    }
}
Set-Alias lka Link-Agent

Usage

In any project directory, simply run:

agent-session

$

lka

Adding @houching/ag-kit via bun…

✅ Successfully added @houching/ag-kit to package.json

Initializing .agents runtime…

Created .agents/ (30 agents, 40 skills, 10 workflows)

This:

1. Adds @houching/ag-kit to your package.json devDependencies using git+ssh.
2. Automatically executes bunx ag-kit init if .agents/ is not yet installed in the current directory.

---

Method 2: Manual Bun / NPM Git URL Install

Without PowerShell aliases, you can run the standard commands in any shell:

1

Add to project dependencies via Git URL

bun add -d git+ssh://git@github.com/houching/ag-kit.git#subdirectory=cli
# Or using npm
npm install -D git+ssh://git@github.com/houching/ag-kit.git#subdirectory=cli

2

Initialize the toolkit

bunx ag-kit init

---

Directory Structure

After initialization, your project contains the standard .agents/ runtime:

.agents/
├── agent/           # 20 Specialist AI Agents
├── skills/          # 45 Domain-specific skills
├── workflows/       # 13 Slash commands
├── rules/           # Workspace and tier rules
├── hooks/           # Native Antigravity safety gates & doctor
├── memory/          # Persistent cross-session project memory
├── ARCHITECTURE.md  # Architectural reference map
└── antigravity.json # Antigravity runtime declaration

💡

Git Exclusion

If you prefer not to commit .agents/ to your repository, add it to your .git/info/exclude or global .gitignore_global.