Defame1297
394052ff66
Re-review (comment 24) of fix commit e16c3dc found six new issues, mostly
introduced by that fix commit itself: a dangling reference to a Hard Rule
bullet the same commit deleted (apm-orchestrate.md/.agent.md Process step
2 still named "secret indirection"), and an ADR-0015 Decision bullet that
claimed "this ADR does not update CONTEXT.md" while the same commit had
just added a forward-pointer sentence to CONTEXT.md's Plugin/Plugin
marketplace entries. Both reworded to match what actually happened.
apm-install's APM_INSTALL_DIR escape-hatch example dropped the curl pipe
entirely (`APM_INSTALL_DIR=... sh` with nothing piped into it) — fixed in
both apm-install/SKILL.md and the installation.md research doc, verified
against the upstream Microsoft APM docs via Context7.
Neither apm-workflow nor apm-orchestrate routed to plain `apm install
[PACKAGE_REF]`, the CLI command that actually resolves/fetches
dependencies declared in apm.yml — apm-install only bootstraps the apm
binary/runtime, not per-package deps. Added a 5th "install" dispatch
action to apm-workflow (new references/install.md, SKILL.md table row,
README usage/files sync, sources.md provenance entry) and a matching
"install" operation group on apm-orchestrate so it can route there.
configure.md's apm.yml schema block was also missing the "legacy singular
`target:` CSV form is still accepted" caveat its sibling research doc
documents for the same field — added for consistency.
The sixth finding (paired .md/.agent.md Output-contract disagreement) was
checked against git-orchestrate and gitea-orchestrate's existing pairs and
found to match established repo convention (JSON schema in .md, prose
summary without the enum in .agent.md) — left unchanged as a false
positive rather than "fixed."
kyberforge bumped 1.3.0 -> 1.3.1 via agent-author's normal improve flow.
Refs: #91
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0186ERbyACLRuRxPRnqwpa4m
2.6 KiB
2.6 KiB
name, description, metadata
| name | description | metadata | |||||
|---|---|---|---|---|---|---|---|
| apm-install | Use when the user wants to install the apm (Agent Package Manager) CLI itself, pin or upgrade its version, set up an air-gapped/enterprise mirror install, or install and manage an agent runtime that apm drives (Copilot CLI, Codex, Gemini, generic llm) — "install apm", "set up apm", "pin apm to a version", "apm runtime setup", "which runtime will apm run pick". Do not use for authoring apm.yml, scaffolding a package/marketplace, compiling, packing, publishing, or running apm audit — use apm-workflow for those. |
|
Gotchas
- apm does not execute agents itself — it only installs and manages the runtimes that do. "Install apm" and "install a runtime apm manages" are two separate steps; don't conflate them or skip the second when the user actually wants a working agent CLI, not just the package manager.
- The air-gapped/enterprise mirror path needs
GITHUB_URLandVERSIONset together against a downloadedinstall.sh— it does not work through the piped one-liner form. pip install apm-clirequires Python 3.10+; the quick-install script has no such prerequisite. Prefer the quick-install script unless the environment is pip-first.- Installing the Copilot CLI runtime through
apm runtime setup copilotrequires Node.js v22+ and npm v10+ already present — apm does not install Node/npm for you.
Install apm
Default:
curl -sSL https://aka.ms/apm-unix | sh
Escape hatches — combine as needed:
- Pin a version: append
@vX.Y.Zto the piped script's arguments, e.g.curl -sSL https://aka.ms/apm-unix | sh -s -- @v1.2.3. - Custom install directory: set
APM_INSTALL_DIRon the piped script's command, e.g.curl -sSL https://aka.ms/apm-unix | APM_INSTALL_DIR=$HOME/.local/bin sh. - Air-gapped / GitHub Enterprise mirror: download
install.shfirst, then run it withGITHUB_URLandVERSIONset, e.g.GITHUB_URL=https://github.corp.com VERSION=v1.2.3 sh install.sh. - pip (Python 3.10+ environments):
pip install apm-cli. - Manual: download the platform archive from the GitHub releases page, extract, place the binary on
PATH.
Verify with apm --version.
Install or manage an agent runtime
Default:
apm runtime setup copilot
Other targets: apm runtime setup codex, apm runtime setup gemini, apm runtime setup llm.
apm runtime list— show installed runtimes.apm runtime status— show which runtimeapm runwill pick by default.apm runtime remove <name> -y— uninstall without an interactive prompt.