yarkr-cli 1.0.0 → 1.0.1

package/README.md

@@ -4,29 +4,60 @@ Install skills, agents and MCP toolsets from [Yarkr](https://yarkr.com) into the
 Claude Code, Codex, opencode, Cursor and more.
 
 ```sh
-npx yarkr-cli add posterus-ltd/code-review-checklist     # a public package, no account needed
-npx yarkr-cli add posterus-ltd/github --harness codex   # pick the harnesses to write
+npm install -g yarkr-cli                                 # Node 22 or newer; or run any command with `npx yarkr-cli …`
+yarkr add posterus-ltd/code-review-checklist            # a public package, no account needed
+yarkr add posterus-ltd/github --harness codex           # pick the harnesses to write
 ```
 
-In a project, `yarkr init` creates `yarkr.json`; `yarkr add` and `yarkr sync` then pin every package in `yarkr.lock`:
+## Sync an ark to your machine
+
+An ark is a curated set of skills, agents and toolsets hosted in the registry. `yarkr sync` writes each one into the
+harness's own layout (`~/.claude/skills/…`, `~/.agents/…`, MCP configs and so on):
+
+```sh
+yarkr arks                                    # list public arks
+yarkr sync acme/starter                       # install one into your home directory
+yarkr sync acme/starter --harness claude-code # only write Claude Code's files
+yarkr ark                                     # what your arks give you, and which version
+```
+
+Signed in, a bare `yarkr sync` installs every ark you're a member of, plus your personal ark. Run it again to pick up
+whatever an admin added or removed; `yarkr sync --check` exits 1 when you're behind.
+
+## Set up an existing repo
+
+In a project, `yarkr init` creates `yarkr.json` (and `.yarkrrc`), detecting the harnesses already used there.
+`yarkr add` and `yarkr sync` then pin every package in `yarkr.lock`, so teammates and CI get the same releases:
 
 ```sh
-npm install -g yarkr-cli
-yarkr init
+cd my-repo
+yarkr init --ark acme/engineering            # optional: install a team's ark into this project
 yarkr add posterus-ltd/playwright-test-authoring
-yarkr sync --check   # in CI: exit 1 when anything is out of date
+git add yarkr.json yarkr.lock .yarkrrc .claude AGENTS.md && git commit
+yarkr sync --check                           # in CI: exit 1 when anything is out of date
 ```
 
-Publishing from a repo? Yarkr finds `SKILL.md` folders, `agents/*.md` and `.mcp.json` on its own. Anything else
-(a skill that's a single markdown file, or a folder with a README instead of SKILL.md) goes in one `yarkr.index.yaml`
-at the root, and nothing has to move:
+To publish from the repo instead, there's nothing to init: Yarkr finds `SKILL.md` folders, `agents/*.md` and
+`.mcp.json` on its own. Anything else (a skill that's a single markdown file, or a folder with a README instead of
+SKILL.md) goes in one `yarkr.index.yaml` at the root, and nothing has to move. Lint it before you push:
 
 ```sh
+yarkr lint                                               # what will be published, and what the hub would refuse
+yarkr lint --strict                                      # in CI: fail on warnings too
 yarkr guide index-repo -o ~/.claude/skills/index-repo/   # a skill your agent uses to write the index
-yarkr lint                                               # what will be published, and what's wrong
 ```
 
-`yarkr` uses the public hub at `https://yarkr.com` unless you point it at your own instance with
-`yarkr login --registry <url>`. Node 22 or newer.
+## Sign in for private packages
+
+Public packages and public arks work signed out. Your org's private packages and arks need a token:
+
+```sh
+yarkr login                  # signs in in the browser; the token goes to your keychain (or ~/.yarkrrc)
+yarkr login --no-browser     # over SSH: open the printed link anywhere, then paste the token
+yarkr whoami                 # check who you're signed in as
+```
+
+In CI, store a read-only token as a secret and set `YARKR_TOKEN`. `yarkr` uses the public hub at `https://yarkr.com`
+unless you point it at your own instance with `yarkr login --registry <url>`.
 
 Docs: [docs/cli.md](https://github.com/posterus-ltd/yarkr-public/blob/main/docs/cli.md) · Source: [github.com/posterus-ltd/yarkr-public](https://github.com/posterus-ltd/yarkr-public) · MIT

package/dist/yarkr.js

@@ -45039,7 +45039,7 @@ async function repoLint(dir, opts) {
 }
 
 // src/index.ts
-var VERSION = true ? "1.0.0" : "0.0.0-dev";
+var VERSION = true ? "1.0.1" : "0.0.0-dev";
 var act = (fn) => async (...a) => {
   await fn(...a);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yarkr-cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Install skills, agents and MCP toolsets from Yarkr into Claude Code, Codex, opencode, Cursor and more",
   "license": "MIT",
   "homepage": "https://yarkr.com",