knowingdog
v0.2.0
Published
Install source-defined Knowing skills and agents and configure GitHub Actions.
Readme
Knowing CLI
The npm package is knowingdog; its installed command is knowing. Requires Node.js 24 or newer.
Install a published space in your coding project:
npx knowingdog add-skill https://your-knowing-host/s/your-spaceThat installs the full space as one skill. To install one authored skill instead:
npx knowingdog add-skill https://your-knowing-host/s/your-space --skill audit-shopifyOnly root skills/<name>/SKILL.md folders are individual skills. Supporting documents and references are bundled, rather than installed as separate skills.
Install the source-defined agent or native plugin:
npx knowingdog add-agent https://your-knowing-host/s/your-space --agent codex
npx knowingdog add-agent https://your-knowing-host/s/your-space --agent claudeReleases after 0.1.1 also accept add-plugin as another name for add-agent.
Codex and Claude plugin manifests are preserved from the published source commit. Restart your coding agent after native registration.
Set up the source-defined GitHub Action:
npx knowingdog init-ci https://your-knowing-host/s/your-spaceThe command creates a pinned workflow and prints required secrets. Existing workflows are preserved. Review, commit and push the generated files.
Use --free for free content or --premium for the complete paid projection. When access is needed, the CLI signs in once if it must (approval continues to the release's access page in the same tab), prints and opens the access link, and installs the same release once the server confirms access. --no-browser prints the link and still waits. Revoked access and tiers that aren't for sale stop at once. Purchases require the creator's checkout to be enabled; the CLI never grants access itself. CI uses a KNOWING_INSTALL_TOKEN secret instead of browser sign-in; create it with knowing login --site https://your-knowing-host --install-only | gh secret set KNOWING_INSTALL_TOKEN.
Publishing and source-grounded docs are also available through publish, sync, docs, search, ask, mcp and mcp-config. Run --help for the command overview.
Sign in for docs and MCP
docs, search, ask and mcp need a customer token for a member of the space or a subscriber to its top tier. Sign in once per Knowing host:
npx knowingdog login --site https://your-knowing-hostThe browser approval stores a customer token locally for 30 days, and the commands send it to that host. On another machine or in CI, set KNOWING_CUSTOMER_TOKEN with KNOWING_SITE naming the same host. logout removes the local token; revoke the terminal under Authorized devices to disable it. Customer-token reading, knowing token, --install-only and the KNOWING_SITE check arrive with the release after 0.1.1.
Node.js 24 or newer is required. See authoring skills and source configuration.
