Agentdeps

agentdeps

Declarative dependency manager for AI coding agent skills and subagents.

Manage skills and subagent definitions from git repositories across multiple coding agents (Pi, Claude Code, Cursor, OpenCode, Codex, Amp, and more) with a single `agents.yaml` file.

Quick Start

# Run without installing
npx agentdeps install

# Or install globally
npm install -g agentdeps

Usage

1. First-run setup

On first use, `agentdeps` will ask you to configure:

• Clone method: SSH or HTTPS
• Target agents: Which coding agents you use (Pi, Claude Code, Cursor, etc.)
• Install method: Link (symlinks, default) or Copy (smart sync)

Re-run anytime with `agentdeps config`.

2. Add dependencies

# Interactive — discover and pick skills/agents
agentdeps add my-org/my-skills-repo

# Install everything from a repo
agentdeps add my-org/my-skills-repo --all

# Cherry-pick specific items
agentdeps add my-org/my-repo --skill frontend-design --skill kotlin-conventions --no-agents

# Specify a git ref
agentdeps add my-org/my-repo --ref v2.0

# Add to global agents.yaml (available in every project)
agentdeps add my-org/my-repo --global
# or: agentdeps add my-org/my-repo -g

3. Install dependencies

agentdeps install

This clones/updates all dependency repos, discovers skills and agents, and installs them into each configured coding agent's directories.

When install changes managed items, the output now includes itemized change groups so you can see exactly what changed:

✓ Project (Pi): 1 skill added, 1 skill updated, 1 skill removed
      skills added: new-skill
      skills updated: my-skill
      skills removed: another-skill

If nothing changed, install stays concise and reports the target as `up to date`.

4. List dependencies

agentdeps list

5. Remove a dependency

agentdeps remove my-org/my-skills-repo

`agents.yaml`

The project-level dependency file:

depen