A CLI tool for centralized management and cross-tool synchronization of LLM Agent Skills, Subagents, and Commands.

• Central skills directory (default): $HOME/.agent-plugins/skills/<skill-name>/
• Central agents directory (default): $HOME/.agent-plugins/agents/<agent-name>/
• Central commands directory (default): $HOME/.agent-plugins/commands/<command-name>/
• add/rm/update commands operate on central items by default.
• sync: Central -> Target tool (one-way copy, supports conflict resolution).
• collect: Target tool -> Central (collects items scattered across different tools, supports conflict resolution).
• Commands support two forms: file-form (single .md file) and directory-form (a directory containing multiple files).

You can override the default directories using environment variables:

• APG_HOME or AGENT_PLUGINS_HOME: Overrides ~/.agent-plugins.
• CODEX_HOME: Overrides Codex's ~/.codex (affects Codex global paths).

This project is developed/built using Bun, but the artifacts can run under Node.js (>= 20):

bun run build
node dist/cli.mjs --help

After publishing to npm, two command entry points will be provided:

• ap (short alias)
• agent-plugins (full name)

Interactive features (selection, conflict resolution, browsing) use an ink-based TUI:

• SkillBrowser / CommandBrowser: Two-panel view with a navigable list on the left and metadata on the right. Supports search (/), vim-style navigation (j/k/f/b/d/u/g/G), and Enter to open.
• FileBrowser: Directory-based navigation for directory-form items.
• FileViewer: Syntax-highlighted file viewer with scrolling support.

skills, agents, and commands share the same lifecycle-style subcommands (add/rm/update/sync/collect/list).

# List central skills
ap skills list
# Find skills (local + remote)
ap skills find [query]
ap skills find react --limit 10
ap skills find react --offline
# Browse and inspect skills (interactive TUI)
ap skills show
# Add a skill (git URL or local path)
ap skills add <git-url|local-path> [--name <skill>] [--ref <ref>] [--force]
# Update skills (based on the source recorded during 'add')
ap skills update [<skill>...] [--all] [--dry-run] [--force]
# Sync: Central -> Target Tool
ap skills sync [<skill>...] --target <target> [--scope local|global] [--dry-run] [--force]
# Collect: Target Tool -> Central
ap skills collect [<skill>...] --target <target> [--scope local|global] [--all] [--dry-run] [--force]
# Remove skills (interactive mode when no args given)
ap skills rm [<skill>...] [--target <...>] [--scope local|global] [--dry-run]

# List central commands
ap commands list
# Find commands (local + remote)
ap commands find [query]
# Browse and inspect commands (interactive TUI)
ap commands show
# Add a command (git URL or local path)
ap commands add <git-url|local-path> [--name <cmd>] [--ref <ref>] [--force]
# Update commands
ap commands update [<command>...] [--all] [--dry-run] [--force]
# Sync: Central -> Target Tool
ap commands sync [<command>...] --target <target> [--scope local|global] [--dry-run] [--force]
# Collect: Target Tool -> Central
ap commands collect [<command>...] --target <target> [--scope local|global] [--all] [--dry-run] [--force]
# Remove commands
ap commands rm [<command>...] [--target <...>] [--scope local|global] [--dry-run]

# List central agents
ap agents list
# Find agents (local + remote)
ap agents find [query]
# Add an agent (git URL or local path)
ap agents add <git-url|local-path> [--name <agent>] [--ref <ref>] [--force]
# Update agents
ap agents update [<agent>...] [--all] [--dry-run] [--force]
# Sync: Central -> Target Tool
ap agents sync [<agent>...] --target <target> [--scope local|global] [--dry-run] [--force]
# Collect: Target Tool -> Central
ap agents collect [<agent>...] --target <target> [--scope local|global] [--all] [--dry-run] [--force]
# Remove agents
ap agents rm [<agent>...] [--target <...>] [--scope local|global] [--dry-run]

Root groups support abbreviations:

Subcommands also support abbreviations (parsed by position):

ap s ls # skills list
ap s a /path # skills add
ap c ls # commands list
ap c show # commands show

--target supports all, comma-separated values (e.g., --target cursor,codex), or repeated flags (e.g., --target cursor --target codex).

Supported targets: cursor, gemini, codex, claude-code, antigravity, openskills, agents, opencode, qoder.

--scope global is the default. --scope local defaults to the git root as the project root (uses current directory if git root is not found).

• Configuration: $APG_HOME/config.json
  • defaultScope (local/global) for each target.
  • include for each target (skills to sync; supports ["*"] for all).
  • includeCommands for each target (commands to sync; supports ["*"] for all).
• State: $APG_HOME/sync-state.json
  • Records the last synced hash for each target/scope (and projectRoot for local). Used to determine if "the target side has been manually modified" and optimize conflict resolution.

• Both sync and collect compare directory content hashes.
• In case of conflict:
  • Non-interactive environment: Requires --force (otherwise exits with error).
  • Interactive environment: Prompts to choose overwrite / backup / skip / keep both ....