Skip to main content

Agent Toolkit Desktop workspace valley, captured from the running app

agent-toolkit-cli

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

PyPI PyPI downloads Python License: MIT Validate Release

npm AUR Homebrew GHCR Discord

skills agents loops

Claude Code Cursor OpenCode Copilot Windsurf Pi Muse Code

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

Agent Toolkit Desktop is a standalone Electron app over the same V backend. It opens with a semantic pixel-art workspace and includes project interiors, People, Library, Operations, and real PTY terminals. Download the installer for your platform from GitHub Releases; a CLI or source checkout is not required to use Desktop. See the Desktop product guide and packaging notes.

Agent Toolkit Desktop — workspace valley with semantic buildings, water and paths
Agent Toolkit Library with coding tool detection and installation evidence

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

Metadata

Release files for agent-toolkit-cli 1.49.0

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.49.0
File Size Uploaded Provenance Actions
agent_toolkit_cli-1.49.0.tar.gz 15.5 MB With provenance Details for agent_toolkit_cli-1.49.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for agent-toolkit-cli 1.49.0
File Actions
agent_toolkit_cli-1.49.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for agent_toolkit_cli-1.49.0-py3-none-win_amd64.whl
agent_toolkit_cli-1.49.0-py3-none-manylinux_2_38_x86_64.whl Python 3 none Linux glibc 2.38+ x86-64 Details for agent_toolkit_cli-1.49.0-py3-none-manylinux_2_38_x86_64.whl
agent_toolkit_cli-1.49.0-py3-none-manylinux_2_38_aarch64.whl Python 3 none Linux glibc 2.38+ ARM64 Details for agent_toolkit_cli-1.49.0-py3-none-manylinux_2_38_aarch64.whl
agent_toolkit_cli-1.49.0-py3-none-macosx_11_0_x86_64.whl Python 3 none macOS 11.0+ x86-64 Details for agent_toolkit_cli-1.49.0-py3-none-macosx_11_0_x86_64.whl
agent_toolkit_cli-1.49.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for agent_toolkit_cli-1.49.0-py3-none-macosx_11_0_arm64.whl

Total release size: 128.9 MB

Release files / agent_toolkit_cli-1.49.0.tar.gz

Download URL agent_toolkit_cli-1.49.0.tar.gz
Size 15.5 MB
Tags Source
SHA-256 checksum
How to use checksums
387946c1b3c1aaa1d881b4dc13c5ffaba9ad447ea75f2afef8111f043efad258
BLAKE2b-256 checksum
How to use checksums
30c3be3b982bcbe44f1e5a4d80987f887cbd0f3c1729dd815a1b25a63c2c639c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

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

Download URL agent_toolkit_cli-1.49.0-py3-none-win_amd64.whl
Size 24.9 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
0b9cc5c3682ba66a0efd657636c2da71955d63d1c8620cd712644435d82998f0
BLAKE2b-256 checksum
How to use checksums
d3ffc5af1828dc4c4ebba205e221d9d559bfcc4e0eabc7e883ca608ccd97f9ba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

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

Download URL agent_toolkit_cli-1.49.0-py3-none-manylinux_2_38_x86_64.whl
Size 22.7 MB
Tags Linux glibc 2.38+ x86-64 Python 3
SHA-256 checksum
How to use checksums
3e30c8be29c6eb5d327d87d17adac76c597f98e158dd4c912f60cf1762c373ac
BLAKE2b-256 checksum
How to use checksums
6c7c8d3be5186dc7905bb109b9038ed25e2e492310daf2ae4a5b66bb161bee66
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

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

Download URL agent_toolkit_cli-1.49.0-py3-none-manylinux_2_38_aarch64.whl
Size 22.4 MB
Tags Linux glibc 2.38+ ARM64 Python 3
SHA-256 checksum
How to use checksums
c8978fdfda9c01eaa68975f6bc0678844c46873af090df7ed1d25c3b11b4730c
BLAKE2b-256 checksum
How to use checksums
bc761a49589a921b37c943faef77963ef7179a7e7a476b36f55ae3fb0ec08840
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

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

Download URL agent_toolkit_cli-1.49.0-py3-none-macosx_11_0_x86_64.whl
Size 21.8 MB
Tags Python 3 macOS 11.0+ x86-64
SHA-256 checksum
How to use checksums
6170b5adfa538440b2477ea986f3e8b90f5786e622c70e968ff97f81c7291bff
BLAKE2b-256 checksum
How to use checksums
febd8e534de48319e5b29a8d7fdaf8d1ff32f93db106f6ffb8c2feeb6f92e491
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

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

Download URL agent_toolkit_cli-1.49.0-py3-none-macosx_11_0_arm64.whl
Size 21.5 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
117739a3389dbe40c249baff5a64f48ac6be3ebf0737d7afb138d450686731a6
BLAKE2b-256 checksum
How to use checksums
92c05cb0451f8b1dbd34b8de67dee8c18da6b83cbcfb27dbafd3d0d09dbf884c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Security for agent-toolkit-cli 1.49.0

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.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for agent_toolkit_cli-1.49.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.49.0 This release

6 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page