$ ls docs/
$ cd ..
──
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)