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.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 apmw 1.1.0
File Size Uploaded Provenance
apmw-1.1.0.tar.gz 72.4 kB Without provenance Details

Built distribution (wheel)

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

Total release size: 81.0 kB

Release files / apmw-1.1.0.tar.gz

Download URL apmw-1.1.0.tar.gz
Size 72.4 kB
Tags Source
SHA-256 checksum
How to use checksums
623ca03909d0348683339bc4884bbac6f0b38d4fd47735080b362fa63730202e
BLAKE2b-256 checksum
How to use checksums
a3b7ed46c1ed7b89e37722e9046824a46e0c94870637a7a19c528e66a4169686
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","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.0-py3-none-any.whl

Download URL apmw-1.1.0-py3-none-any.whl
Size 8.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f51849cae5188b60730601de916e72cecd9b1fa31fa959aca13c20028d19443b
BLAKE2b-256 checksum
How to use checksums
2d07180c6300b7fbae98142f2a402b6e6b0cf2e097179e6270af3b3fb1453a01
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","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.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.

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.

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

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