withastro/rosie — docs/how-it-works
$ ls docs/
── how it works

a single C program (also compiled to wasm for the npm package). what happens when you run rosie install owner/repo:

rosie install owner/repo
   │
   ├─▶ parse package spec  (owner/repo[@ref][#skill])
   │
   ├─▶ resolve ref         (latest semver tag · branch · pinned ref)
   │
   ├─▶ download tarball    (libcurl native · fetch in wasm)
   │   https://github.com/owner/repo/archive/refs/heads/main.tar.gz
   │
   ├─▶ extract             (libarchive)
   │
   ├─▶ discover skills     (walk for SKILL.md, parse YAML frontmatter)
   │
   ├─▶ detect agents       (check ~/.claude, ~/.cursor, …)
   │
   └─▶ install
       local:  copy to .agents/skills/, symlink to each agent
       global: copy directly to each ~/.<agent>/skills/
               (local paths are symlinked in place, tracked in ~/.agents/rosie.lock)
  • native binary single small executable · no node, no python, no jvm runtime · ships for linux-x64, darwin-arm64, freebsd-x64
  • wasm fallback inlined into the npm package · works on every platform node runs · powers the js api
  • deps libcurl + libarchive (system on linux/freebsd · static on macos · emscripten ports + node fetch in wasm)