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

Desktop GUI

Prefer a graphical workspace? The native desktop app runs over the same Engine — Office, Library, Operations, and an embedded terminal:

agent-toolkit gui --install   # download the desktop binary from GitHub Releases
agent-toolkit gui             # launch it (alias: agent-toolkit desktop)

Agent Toolkit Desktop — Office floor with agent desks, roster, and embedded terminal

Library: searchable skills catalog with detail inspector

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

Release files for agent-toolkit-cli 1.32.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-toolkit-cli 1.32.1
File	Size	Uploaded
agent_toolkit_cli-1.32.1.tar.gz	859.4 kB	Sep 20, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for agent-toolkit-cli 1.32.1
File	Interpreter	ABI	Platform	Reset
agent_toolkit_cli-1.32.1-py3-none-win_amd64.whl 7.0 MB Sep 20, 2026	Python 3	none	Windows x86-64	Details
agent_toolkit_cli-1.32.1-py3-none-manylinux_2_38_x86_64.whl 6.0 MB Sep 20, 2026	Python 3	none	Linux glibc 2.38+ x86-64	Details
agent_toolkit_cli-1.32.1-py3-none-manylinux_2_38_aarch64.whl 5.9 MB Sep 20, 2026	Python 3	none	Linux glibc 2.38+ ARM64	Details
agent_toolkit_cli-1.32.1-py3-none-macosx_11_0_x86_64.whl 5.4 MB Sep 20, 2026	Python 3	none	macOS 11.0+ x86-64	Details
agent_toolkit_cli-1.32.1-py3-none-macosx_11_0_arm64.whl 5.3 MB Sep 20, 2026	Python 3	none	macOS 11.0+ ARM64	Details

Total release size: 30.5 MB

Release files / agent_toolkit_cli-1.32.1.tar.gz

Download URL	agent_toolkit_cli-1.32.1.tar.gz
Size	859.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`1d3ea08d16ecb4b8b0bfd80b2226c4b376198e7e4734d3e44edd7fd224c56ba8`
BLAKE2b-256 checksum How to use checksums	`b274329244693084670a6b52090427a381099c16d3c90b4e3ce69ad9bba378a7`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ulises-jeremias/agent-toolkit
Publishing commit: github.com/ulises-jeremias/agent-toolkit/tree/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8

Workflow

Publishing configuration: github.com/ulises-jeremias/agent-toolkit/blob/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8/.github/workflows/release.yml
Publishing logs: github.com/ulises-jeremias/agent-toolkit/actions/runs/35491618990/attempts/1

Artifact

Subject: agent_toolkit_cli-1.32.1.tar.gz
SHA-256 checksum: 1d3ea08d16ecb4b8b0bfd80b2226c4b376198e7e4734d3e44edd7fd224c56ba8 Verifying attestations

Release files / agent_toolkit_cli-1.32.1-py3-none-win_amd64.whl

Download URL	agent_toolkit_cli-1.32.1-py3-none-win_amd64.whl
Size	7.0 MB
Tags	Python 3 Windows x86-64
SHA-256 checksum How to use checksums	`0cfbd61914d82e4c449b18f966e5a0bce15eb3aa521cf523dea895aaf65e5329`
BLAKE2b-256 checksum How to use checksums	`fe0d44212b873283fe0f163033c8918c7e012769541e845417f84ac5d8bf2664`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ulises-jeremias/agent-toolkit
Publishing commit: github.com/ulises-jeremias/agent-toolkit/tree/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8

Workflow

Publishing configuration: github.com/ulises-jeremias/agent-toolkit/blob/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8/.github/workflows/release.yml
Publishing logs: github.com/ulises-jeremias/agent-toolkit/actions/runs/35491618990/attempts/1

Artifact

Subject: agent_toolkit_cli-1.32.1-py3-none-win_amd64.whl
SHA-256 checksum: 0cfbd61914d82e4c449b18f966e5a0bce15eb3aa521cf523dea895aaf65e5329 Verifying attestations

Release files / agent_toolkit_cli-1.32.1-py3-none-manylinux_2_38_x86_64.whl

Download URL	agent_toolkit_cli-1.32.1-py3-none-manylinux_2_38_x86_64.whl
Size	6.0 MB
Tags	Linux glibc 2.38+ x86-64 Python 3
SHA-256 checksum How to use checksums	`82d3e60e5e7cb1a8586d81357fec6190e229b2e5b7492f0c20343dd168dc2d1e`
BLAKE2b-256 checksum How to use checksums	`28dd49eee8b75f4569d0a5622fe9f333cf18d36a4b4b61f11990731526a46814`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ulises-jeremias/agent-toolkit
Publishing commit: github.com/ulises-jeremias/agent-toolkit/tree/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8

Workflow

Publishing configuration: github.com/ulises-jeremias/agent-toolkit/blob/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8/.github/workflows/release.yml
Publishing logs: github.com/ulises-jeremias/agent-toolkit/actions/runs/35491618990/attempts/1

Artifact

Subject: agent_toolkit_cli-1.32.1-py3-none-manylinux_2_38_x86_64.whl
SHA-256 checksum: 82d3e60e5e7cb1a8586d81357fec6190e229b2e5b7492f0c20343dd168dc2d1e Verifying attestations

Release files / agent_toolkit_cli-1.32.1-py3-none-manylinux_2_38_aarch64.whl

Download URL	agent_toolkit_cli-1.32.1-py3-none-manylinux_2_38_aarch64.whl
Size	5.9 MB
Tags	Linux glibc 2.38+ ARM64 Python 3
SHA-256 checksum How to use checksums	`cf479e642a396d05bf0efd127fb862f58d3b3c92f9427e7a3f85690939473d37`
BLAKE2b-256 checksum How to use checksums	`e2974cc72e9e8cbb7bf5eb2983c9fb6b7cbca6d19f592675f1b98fe49eb9c038`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ulises-jeremias/agent-toolkit
Publishing commit: github.com/ulises-jeremias/agent-toolkit/tree/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8

Workflow

Publishing configuration: github.com/ulises-jeremias/agent-toolkit/blob/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8/.github/workflows/release.yml
Publishing logs: github.com/ulises-jeremias/agent-toolkit/actions/runs/35491618990/attempts/1

Artifact

Subject: agent_toolkit_cli-1.32.1-py3-none-manylinux_2_38_aarch64.whl
SHA-256 checksum: cf479e642a396d05bf0efd127fb862f58d3b3c92f9427e7a3f85690939473d37 Verifying attestations

Release files / agent_toolkit_cli-1.32.1-py3-none-macosx_11_0_x86_64.whl

Download URL	agent_toolkit_cli-1.32.1-py3-none-macosx_11_0_x86_64.whl
Size	5.4 MB
Tags	Python 3 macOS 11.0+ x86-64
SHA-256 checksum How to use checksums	`f62760b09154eb2aab1c950e22273beac7eec39ffbc4d64261acb976ba227373`
BLAKE2b-256 checksum How to use checksums	`cd68f9f031c77477307d48602c66a44f5bf60e8467ee2bff111d11d9456cb002`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ulises-jeremias/agent-toolkit
Publishing commit: github.com/ulises-jeremias/agent-toolkit/tree/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8

Workflow

Publishing configuration: github.com/ulises-jeremias/agent-toolkit/blob/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8/.github/workflows/release.yml
Publishing logs: github.com/ulises-jeremias/agent-toolkit/actions/runs/35491618990/attempts/1

Artifact

Subject: agent_toolkit_cli-1.32.1-py3-none-macosx_11_0_x86_64.whl
SHA-256 checksum: f62760b09154eb2aab1c950e22273beac7eec39ffbc4d64261acb976ba227373 Verifying attestations

Release files / agent_toolkit_cli-1.32.1-py3-none-macosx_11_0_arm64.whl

Download URL	agent_toolkit_cli-1.32.1-py3-none-macosx_11_0_arm64.whl
Size	5.3 MB
Tags	Python 3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`f3e9280a1c460a127a9526e92d539702f4cbb4b3b1412e3d514a5bada8c5d2b7`
BLAKE2b-256 checksum How to use checksums	`ba63df9597b3756b495f012dddf0557145e8534a7ddefcd48fe4fc7756b3db9f`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ulises-jeremias/agent-toolkit
Publishing commit: github.com/ulises-jeremias/agent-toolkit/tree/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8

Workflow

Publishing configuration: github.com/ulises-jeremias/agent-toolkit/blob/0092d9c7b4d6dd70f8384d4c6af0dba4093ab5a8/.github/workflows/release.yml
Publishing logs: github.com/ulises-jeremias/agent-toolkit/actions/runs/35491618990/attempts/1

Artifact

Subject: agent_toolkit_cli-1.32.1-py3-none-macosx_11_0_arm64.whl
SHA-256 checksum: f3e9280a1c460a127a9526e92d539702f4cbb4b3b1412e3d514a5bada8c5d2b7 Verifying attestations