agent-toolkit banner

agent-toolkit-cli

The official CLI for agent-toolkit — install skills, agents, loops, and MCP configs across every major AI coding assistant.

PyPI Python License: MIT Validate

skills agents loops

Claude Code Cursor OpenCode Copilot Windsurf Pi

Monorepo · Docs · Installation · CLI surfaces · Changelog

What is this package?

agent-toolkit-cli is the published Python entrypoint for the agent-toolkit monorepo. It ships:

  • the agent-toolkit / agent-toolkit-cli console scripts
  • bundled skills, agents, loops, profiles, packs, and MCP templates
  • install / doctor / sync workflows that deploy the right artifacts per AI tool

One CLI. Any coding assistant. Zero duplication.

uvx --from agent-toolkit-cli agent-toolkit install
agent-toolkit doctor
agent-toolkit architecture

Quick start

Recommended: uv — no permanent install required.

# One-shot (preferred)
uvx --from agent-toolkit-cli agent-toolkit install
uvx --from agent-toolkit-cli agent-toolkit doctor

# Or install the CLI persistently
uv tool install agent-toolkit-cli
agent-toolkit install    # auto-detects Claude, Cursor, OpenCode, Windsurf, Pi, Copilot
agent-toolkit doctor

Other installers

pip install agent-toolkit-cli
pipx install agent-toolkit-cli

# System packages (release notify → dedicated taps)
brew tap ulises-jeremias/homebrew-tap && brew install agent-toolkit
yay -S agent-toolkit   # Arch Linux (AUR)

Full walkthrough: docs/INSTALLATION.md

Key concepts

🛠️ Skills

Reusable capability units (SKILL.md) that teach an agent how to do a job — delivery, forge CLIs, design, data, ops.

52 skills across 9 domains. Browse with agent-toolkit inventory or agent-toolkit skills list.

🤖 Agents

Personas that constrain how the AI works — review, plan, architect, fix CI — without rewriting prompts each time.

16 personas, compiled into each target's native format via install.

🔄 Loops

Recurring agentic workflows with mutation-safety tiers (L1 observe → L2 controlled → L3 high autonomy).

agent-toolkit loop run daily-triage · 10 bundled templates

🔗 MCP

Provider registry + ready templates (GitHub, Slack, Notion, Linear, Figma, ClickUp) emitted into target-native configs.

agent-toolkit mcp list · mcp setup <provider> · mcp doctor

Supported tools

Supported AI tools grid
Tool What install deploys
Claude Code Plugin manifest, skill references, settings
Cursor Marketplace plugins + .mdc rules (IDE + Agent CLI)
OpenCode System prompt overlays, agent configs
GitHub Copilot copilot-instructions.md with domain selection
Windsurf Rules and memory files via Cascade (~/.codeium/windsurf/)
Pi Agent Skills and loop templates in Pi's native format 
# Target specific tools
agent-toolkit install --tools claude-code,cursor
agent-toolkit install --dry-run
agent-toolkit install --force

Command reference

Everyday consumer commands vs advanced workstation / harness commands. Details: docs/CLI_SURFACES.md

Consumer

Command Purpose
install Install profiles for detected or selected AI tools
update Refresh installed profiles from latest toolkit data
uninstall Remove toolkit-owned files using install receipts
doctor Check toolkit data and tool availability
diff Show changes vs currently installed plugin bundles
skills Sync, list, and validate skills
mcp MCP provider setup, health, doctor, uninstall
plugin Plugin bundle sync and check 
agent-toolkit skills list
agent-toolkit skills sync --tools claude-code,cursor
agent-toolkit mcp setup github
agent-toolkit doctor --fix

Advanced

Still on the same binary — start here when running an agentic-harness-style workspace:

Command Purpose
loop Loop engineering: init, run, status, audit, cost, schedule, sync
workspace Workspace scaffolding: init, context, personas, packs
memory Knowledge base: add, search, inject, review, todo
project Project index: clone, list, add, remove, scan
devcompanion Background job queue (dc alias)
insights Local usage analytics (OpenCode, Cursor, Claude)
inventory List skills, agents, and products
matrix Platform capability matrix
build / release Compile / release artifacts (maintainer) 
# Loops (mutation-safety tiers L1 → L3)
agent-toolkit loop init daily-triage
agent-toolkit loop run daily-triage
agent-toolkit loop status
agent-toolkit loop audit daily-triage

# Workspace harness
agent-toolkit workspace init --dir ~/.agentic-harness
agent-toolkit memory search "topic"
agent-toolkit project clone owner/my-repo
agent-toolkit inventory
Loop autonomy tiers
Tier Posture Examples
L1 Observe / propose (report-only) oss-daily-briefing, daily-triage, oss-triage
L2 Controlled mutations (PR-gated) ci-sweeper, dep-sweeper, pr-babysitter
L3 High autonomy (allowlist) oss-pr-monitor

Optional dependencies

# YAML-backed pack / catalog features
uv tool install "agent-toolkit-cli[yaml]"

# Everything optional
uv tool install "agent-toolkit-cli[all]"
Extra Provides
yaml PyYAML for pack overlays and richer catalog parsing
all Currently same as yaml
dev pytest, ruff (contributors)

Upgrade & uninstall

uv tool upgrade agent-toolkit-cli
agent-toolkit update          # refresh deployed profiles
agent-toolkit uninstall       # remove toolkit-owned files via receipts

uv tool uninstall agent-toolkit-cli
# or: pip uninstall agent-toolkit-cli

→ docs/UNINSTALL.md

Ecosystem

agent-toolkit is the capability distribution layer (L1.5) in a personal DX stack:

Layer Repo Role
L1 agentic-workstation Machine provisioning — chezmoi, shell, packages, LLM policy
L1.5 agent-toolkit (this CLI) Skills, loops, profiles, MCP
L3 agentic-harness AI workspace scaffold — memory, personas, multi-repo orchestration

Documentation

Guide Description
README (monorepo) Full product overview, skills, agents, packs
INSTALLATION.md Install paths per tool
CLI_SURFACES.md Consumer vs advanced commands
LOOPS.md Loop engineering reference
TRUST.md Trust boundaries and supply chain
COMPATIBILITY.md Python / tool matrix
Wiki Extended reference

Canonical sources live in the agent-toolkit monorepo. This package is the installable distribution of that source of truth.

Requirements

  • Python 3.10+
  • Optional: uv for uvx / uv tool workflows
  • At least one supported AI coding assistant (for install to deploy profiles)

Contributing

Issues and PRs welcome on the monorepo:

git clone https://github.com/ulises-jeremias/agent-toolkit
cd agent-toolkit
uv sync
uv run agent-toolkit --help

MIT © ulises-jeremias · PyPI · GitHub

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.6.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ulises-jeremias from gravatar.com ulises-jeremias

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT License)

Requires

Python >=3.10

Provides Extra

all dev yaml

Tags

agent-toolkit agent-toolkit-cli ai-agents claude-code cursor github-copilot loops mcp opencode skills windsurf

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_toolkit_cli-1.4.0.tar.gz (501.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent_toolkit_cli-1.4.0-py3-none-any.whl (697.8 kB view details)

Uploaded Python 3

File details

Details for the file agent_toolkit_cli-1.4.0.tar.gz.

File metadata

  • Download URL: agent_toolkit_cli-1.4.0.tar.gz
  • Upload date:
  • Size: 501.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent_toolkit_cli-1.4.0.tar.gz
Algorithm Hash digest
SHA256 fe60a703d63230a0ca292401e0a603f535ac4e2630f7d41b8941f8c6b6282943
MD5 0fc7c698eafcfaec1d129e506e0be4b0
BLAKE2b-256 20dd66428a19e0878ea7b7fd44b18b5b50fa6a89e35ea3ce5334a093b83da128

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_toolkit_cli-1.4.0.tar.gz:

Publisher: release.yml on ulises-jeremias/agent-toolkit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agent_toolkit_cli-1.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_toolkit_cli-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 04eb2e0c545e6dbc815ca93de7fd7d78823d80ad0c3d3493eeb38e2cb0115531
MD5 511cec9f434e9448194b877840916301
BLAKE2b-256 01b74fed98674a6138ba55df1815dccc793a9f97936b792b6c15674aa655fb16

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_toolkit_cli-1.4.0-py3-none-any.whl:

Publisher: release.yml on ulises-jeremias/agent-toolkit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page