agentget

Install AI agents, instructions, skills, and rules from GitHub repos into your project.

Installation

# npm
npm install -g agentget

# bun
bun add -g agentget

Or use without installing via npx / bunx:

npx agentget add owner/repo
bunx agentget add owner/repo

Usage

# Both of these work:
npx agentget add owner/repo
npx agent-get add owner/repo

# Install all agents (default)
npx agentget add owner/repo

# Install everything (agents, skills, instructions, rules)
npx agentget add owner/repo --all

# Install specific agent + all skills/instructions/rules
npx agentget add owner/repo --agent code-reviewer

# Install only skills
npx agentget add owner/repo --skills-only

# Install only instructions
npx agentget add owner/repo --instructions-only

# Install only rules
npx agentget add owner/repo --rules-only

# Install specific agent only (no skills/instructions/rules)
npx agentget add owner/repo --agent code-reviewer --agents-only

# Use alternative directory names (for repos with non-standard structure)
npx agentget add VoltAgent/awesome-claude-code-subagents --agents-dir categories

List Installed

# List installed agents (default)
npx agentget list

# List everything (agents, skills, instructions, rules)
npx agentget list --all

# List only agents
npx agentget list --agents-only

# List only skills
npx agentget list --skills-only

# List only instructions
npx agentget list --instructions-only

# List only rules
npx agentget list --rules-only

Filtering

Alternative Directory Names

For repos with non-standard structure, specify custom directory names:

Note: Agents directory scanning is recursive — finds .md and .agent.md files in all subdirectories.

Frontmatter Handling

YAML frontmatter (content between --- delimiters at the start of files) is automatically stripped during installation. This ensures compatibility with tools that don't support frontmatter or have different frontmatter requirements.

Example:

---
name: ui-designer
tools: Read, Write, Edit
---

You are a UI designer...

Becomes:

You are a UI designer...

What it installs

Content is discovered from these patterns in the target repo:

Where files go

agentget supports 41 AI coding tools. Content is always written to a canonical location first, then symlinked to detected tool directories.

Supported vs Detected

• Supported — all 41 tools agentget knows how to install into. Run agentget targets to list them.
• Detected — the subset whose config directories exist on your machine right now. Only detected targets receive symlinks, avoiding unused dot-directories.
• Canonical — 10 tools that read .agents/ directly and are always active. No symlink needed.

Canonical (source of truth)

.agents/agents/<name>.agent.md
.agents/instructions/<name>.instructions.md
.agents/skills/<name>/
.agents/rules/<name>.rules.md

Canonical readers (always active)

These tools read .agents/ directly — no symlinks needed:

AMP, Cline, Codex, Cursor, Gemini CLI, GitHub Copilot, Kimi Code CLI, OpenCode, Replit, Universal

Project targets

Symlinks created when the tool's project directory is detected:

Global targets

Global symlinks are only created when the tool's config directory already exists (or an env var like CLAUDE_CONFIG_DIR / CODEX_HOME points to it). This avoids spraying unused dot-directories across your home directory.

All global paths contain {agents,instructions,skills,rules}/ subdirectories.

Builtin Agents

agentget ships a curated set of agents you can install directly from this repo:

npx agentget add joeyism/agentget --agent <name>