@knowledge-forge-ai/apgr
v0.12.0
Published
The Agentic Praxis Grimoire command launcher.
Maintainers
Readme
@knowledge-forge-ai/apgr
The official npm launcher for Agentic Praxis Grimoire (APGR).
APGR is a provider-neutral toolkit and skill corpus for bounded agent engineering, providing deterministic context bundles, evidence collection, environment snapshots, hotspot analysis, and context-footprint accounting.
Architecture
This package is a lightweight, zero-dependency Node.js launcher. It contains no runtime semantics itself. When invoked, it:
- Inspects
process.platformandprocess.archto identify the target host. - Locates the matching platform package (
@knowledge-forge-ai/apgr-darwin-arm64,@knowledge-forge-ai/apgr-linux-x64, or@knowledge-forge-ai/apgr-linux-arm64). - Verifies the prebuilt Go binary and its companion
apg.binary-manifest/v1integrity manifest. - Executes the verified binary with exact arguments, inherited stdio, and
shell: false.
All operational behavior, skill resolution, footprint accounting, and reporting logic reside exclusively in the verified Go binary.
Package Contents and Dispatch Boundaries
The launcher and platform packages execute runtime command families (skills, footprint, env, analyze hotspots, report, response).
These packages do not carry repository maintenance runners, policy checks, or test suites. The CI qualification runner (apgr test) requires an APGR Git source checkout and the developer toolchain (Python 3.11+, pytest stack, Git 2.40+, Go 1.25+).
Installation
Once this version is published, install globally via npm:
npm install -g @knowledge-forge-ai/[email protected]
apgr --versionOr execute directly via npx:
npx @knowledge-forge-ai/[email protected] --versionNote on candidate versions: Prior to publication, unpublished candidate releases are not available on npm; test candidate features directly from an APGR Git checkout.
Supported Platforms
darwin/arm64(macOS Apple Silicon) ->@knowledge-forge-ai/apgr-darwin-arm64linux/x64(Linux x86_64 / amd64) ->@knowledge-forge-ai/apgr-linux-x64linux/arm64(Linux aarch64) ->@knowledge-forge-ai/apgr-linux-arm64
Requirements: Node.js >=22.0.0.
Developer qualification gate status: Darwin arm64 has historical integrated source qualification. Current candidate qualification is separate; developer qualification on Linux x86_64 remains pending.
License
AGPL-3.0-or-later. Commercial licensing options are available at https://www.knowledge-forge.ai.
