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.

skills agents loops

Monorepo · Docs · Installation · CLI surfaces · Changelog

What is this package?

agent-toolkit-cli is the PyPI adapter for the agent-toolkit monorepo (ADR-021). Platform wheels bundle the native V binary; agent-toolkit / agent-toolkit-cli are a thin trampoline (same idea as the npm package). There is no Python CLI fallback — see python-fallback.md.

It also ships:

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

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-bin   # Arch Linux (AUR) — GitHub Release V binary; not the Python AUR package
docker pull ghcr.io/ulises-jeremias/agent-toolkit

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.} _{80 skills across 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.} _{17 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

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
Muse Code	Agent Skills under `~/.config/muse/skills/`

# 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

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 --project packages/pypi/agent-toolkit-cli --all-extras
uv run --project packages/pypi/agent-toolkit-cli --directory . agent-toolkit --help

MIT © ulises-jeremias · PyPI · npm · AUR · GitHub

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.22.1.tar.gz (560.7 kB view details)

Uploaded Aug 24, 2026 Source

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

agent_toolkit_cli-1.22.1-py3-none-win_amd64.whl (5.0 MB view details)

Uploaded Aug 24, 2026 Python 3Windows x86-64

agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_x86_64.whl (5.0 MB view details)

Uploaded Aug 24, 2026 Python 3manylinux: glibc 2.38+ x86-64

agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_aarch64.whl (5.3 MB view details)

Uploaded Aug 24, 2026 Python 3manylinux: glibc 2.38+ ARM64

agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_x86_64.whl (4.0 MB view details)

Uploaded Aug 24, 2026 Python 3macOS 11.0+ x86-64

agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_arm64.whl (4.0 MB view details)

Uploaded Aug 24, 2026 Python 3macOS 11.0+ ARM64

File details

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

File metadata

Download URL: agent_toolkit_cli-1.22.1.tar.gz
Upload date: Aug 24, 2026
Size: 560.7 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.22.1.tar.gz
Algorithm	Hash digest
SHA256	`33c80702e630ee50e9e99997c41404fb18da68eceb4fac3e697b6f0e02e24de2`
MD5	`61198363e25935dd0fad2735edce6f45`
BLAKE2b-256	`832a02abfc5ad5cc8929e247bb2dfabb8cd0fae2cb509e5106fde721997568c5`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_toolkit_cli-1.22.1.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: agent_toolkit_cli-1.22.1.tar.gz
- Subject digest: 33c80702e630ee50e9e99997c41404fb18da68eceb4fac3e697b6f0e02e24de2
- Sigstore transparency entry: 2581172497
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: ulises-jeremias/agent-toolkit@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Branch / Tag: refs/tags/v1.22.1
- Owner: https://github.com/ulises-jeremias
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Trigger Event: push

File details

Details for the file agent_toolkit_cli-1.22.1-py3-none-win_amd64.whl.

File metadata

Download URL: agent_toolkit_cli-1.22.1-py3-none-win_amd64.whl
Upload date: Aug 24, 2026
Size: 5.0 MB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent_toolkit_cli-1.22.1-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`c835446bdd1b6842727e8148e8b2482045f025711d5499b8968508782c63ca17`
MD5	`3f28cb08db0d38ed6b4325e56940bb85`
BLAKE2b-256	`0979d4a59927c8b710fcde97093a150c5437075e2276eced8b5b28627a932926`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_toolkit_cli-1.22.1-py3-none-win_amd64.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: agent_toolkit_cli-1.22.1-py3-none-win_amd64.whl
- Subject digest: c835446bdd1b6842727e8148e8b2482045f025711d5499b8968508782c63ca17
- Sigstore transparency entry: 2581172528
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: ulises-jeremias/agent-toolkit@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Branch / Tag: refs/tags/v1.22.1
- Owner: https://github.com/ulises-jeremias
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Trigger Event: push

File details

Details for the file agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_x86_64.whl.

File metadata

Download URL: agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_x86_64.whl
Upload date: Aug 24, 2026
Size: 5.0 MB
Tags: Python 3, manylinux: glibc 2.38+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_x86_64.whl
Algorithm	Hash digest
SHA256	`910f6446dd4d36525f33ce64a2d78d0824826acbcfb269f0d9ba48d48db5a5ef`
MD5	`71877702dc9654ee3ac2b4b84d494919`
BLAKE2b-256	`8f97e95f856da0c49d84d0e63ae86bde345547c99511d0136583574bdc7d1766`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_x86_64.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_x86_64.whl
- Subject digest: 910f6446dd4d36525f33ce64a2d78d0824826acbcfb269f0d9ba48d48db5a5ef
- Sigstore transparency entry: 2581172535
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: ulises-jeremias/agent-toolkit@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Branch / Tag: refs/tags/v1.22.1
- Owner: https://github.com/ulises-jeremias
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Trigger Event: push

File details

Details for the file agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_aarch64.whl.

File metadata

Download URL: agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_aarch64.whl
Upload date: Aug 24, 2026
Size: 5.3 MB
Tags: Python 3, manylinux: glibc 2.38+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_aarch64.whl
Algorithm	Hash digest
SHA256	`2ab5b537df693571da27bf61230847fa755f52db200b6d536cfc51b9a3ca2de5`
MD5	`988b370891b7e4de86ba06aa2ecd504a`
BLAKE2b-256	`686c219a9df85ac7d1f54164158fb1067229743e8700632041726222898ad3f4`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_aarch64.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: agent_toolkit_cli-1.22.1-py3-none-manylinux_2_38_aarch64.whl
- Subject digest: 2ab5b537df693571da27bf61230847fa755f52db200b6d536cfc51b9a3ca2de5
- Sigstore transparency entry: 2581172503
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: ulises-jeremias/agent-toolkit@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Branch / Tag: refs/tags/v1.22.1
- Owner: https://github.com/ulises-jeremias
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Trigger Event: push

File details

Details for the file agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_x86_64.whl.

File metadata

Download URL: agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_x86_64.whl
Upload date: Aug 24, 2026
Size: 4.0 MB
Tags: Python 3, macOS 11.0+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_x86_64.whl
Algorithm	Hash digest
SHA256	`c9c96fca414adab82ae7ef5571b75784ac5f9acb0846b066e2d9299d3df04dc5`
MD5	`5e31aa2095eb8fc8303df4c3a849de28`
BLAKE2b-256	`c9c7a2bcf7bb4e4f1d84059bde473e4f306de479dd0253d323320b90d6137535`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_x86_64.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_x86_64.whl
- Subject digest: c9c96fca414adab82ae7ef5571b75784ac5f9acb0846b066e2d9299d3df04dc5
- Sigstore transparency entry: 2581172520
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: ulises-jeremias/agent-toolkit@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Branch / Tag: refs/tags/v1.22.1
- Owner: https://github.com/ulises-jeremias
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Trigger Event: push

File details

Details for the file agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_arm64.whl
Upload date: Aug 24, 2026
Size: 4.0 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`094dac0263cfa9b63da92f23547a05019db9494c10f3b32d0aa0834d22268a4a`
MD5	`49ddc1b86403807df27e84d52d08e9f3`
BLAKE2b-256	`ebb94c41d23ef5566d02ff8282515459a7e1931624aca734d2c82bffcff6da4d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_arm64.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: agent_toolkit_cli-1.22.1-py3-none-macosx_11_0_arm64.whl
- Subject digest: 094dac0263cfa9b63da92f23547a05019db9494c10f3b32d0aa0834d22268a4a
- Sigstore transparency entry: 2581172513
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: ulises-jeremias/agent-toolkit@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Branch / Tag: refs/tags/v1.22.1
- Owner: https://github.com/ulises-jeremias
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@bfb6223a0ca1dd3168598d10b865c51a75e337e8
- Trigger Event: push