Skip to main content

apmw

PyPI License: MIT Docs

Documentation · User guide on GitHub · Changelog

Cross-platform wrapper for the apm CLI.

apm install and apm update deploy platform-neutral skills cleanly, but agent files carry platform-specific frontmatter (permission, mode, tools, …) that each target — Claude Code, OpenCode, GitHub Copilot, Cursor, Codex — interprets differently. apmw runs the real apm command and then sanitizes the installed agent frontmatter for the platform you specify.

Install

pipx install apmw           # or: uv tool install apmw
apmw install -p claude

To run it once without installing, use uvx; nothing stays on your PATH:

uvx apmw install -p claude

Prebuilt single-file executables (Linux, macOS arm64, Windows) that need no Python environment are attached to each GitHub release.

Usage

apmw install -p claude      # apm install + sanitize for Claude Code
apmw update  -p copilot     # apm update + sanitize for GitHub Copilot
apmw sanitize -g -p opencode  # sanitize the global OpenCode agent dir, no apm call

Everything else — flags, global install of the apm-hub packages, authoring agents for several platforms from one source file, strip rules and per-platform references — is in the user guide.

Development

uv sync
uv run pytest

See docs/guide/development.md and AGENTS.md.

License

MIT

Metadata

Release files for apmw 1.1.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 apmw 1.1.1
File Size Uploaded Provenance
apmw-1.1.1.tar.gz 72.7 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for apmw 1.1.1
File Interpreter ABI Platform
apmw-1.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 81.3 kB

Release files / apmw-1.1.1.tar.gz

Download URL apmw-1.1.1.tar.gz
Size 72.7 kB
Tags Source
SHA-256 checksum
How to use checksums
2e17bc08b84072395918a2fb0471fba2346d5607aef3e089e7b9e5676b597d0e
BLAKE2b-256 checksum
How to use checksums
b56a1c6e7a31b9154b3a4b3b049d1fe75031ccaad2a8cb8d1bb7728114e4e4f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / apmw-1.1.1-py3-none-any.whl

Download URL apmw-1.1.1-py3-none-any.whl
Size 8.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d7f7ff3d8ce02ba37e2bdec82d5316517ee691f768760c06c36aa9bea5856ae3
BLAKE2b-256 checksum
How to use checksums
a701e104fd31b9d86c460c92aebe75437691f1c15f0cde9a7a66e0044a125288
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for apmw 1.1.1

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

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