Skip to content

CLI Discover

Mel edited this page Nov 10, 2026 · 1 revision

These commands read the stack and merge in cached remote libraries. They never write to a project. A read may refresh a stale remote cache first (see CLI Remote Libraries).

list

stack list [kind]        # alias: stack ls

Lists every entry, one group per kind, or only one kind. The kind can be singular or plural: skill or skills, worker or workers. The kinds are skill, style, system, component, library, asset, template and worker.

$ stack list workers --plain
- workers/mel [reference, experimental]: How to work with Mel (9kdr), escacs co-owner: semi-technical client who judges visible results. Import into any project Mel runs; the project's own AGENTS.md overrides on details.
- workers/yuno [reference, experimental]: How to work with Yuno (skyyuno), escacs co-owner: technical owner who expects autonomous, parallel, evidence-backed agent work. Import into any project Yuno runs; the project's own AGENTS.md overrides on details.

A plain line is - <id> [<usage>, <status>]: <summary>. The status part is left out when the entry is stable. usage says how a kind is meant to be used: link (skills, styles), copy (components, assets, templates), reference (systems, workers) or package (libraries). An entry's own manifest can set a different usage.

With --json, list and search return { command, kind?, query?, count, entries, uncommitted, remotes }. Each entry is the catalog row plus committed, files, bytes and preview. uncommitted lists the returned ids that have uncommitted changes in the stack. Only committed entries (and remote members) can be imported.

search

stack search <query> [--kind <kind>]

Keyword search over names, tags, summaries and docs. It returns at most 10 matches, best first. The query is every word after the command, so stack search pull request is the same as stack search "pull request". Use -- to search for text that looks like a flag:

$ stack search pull request --kind skill --plain
- skills/babysit-pr [link]: Watch a pull request through CI and review bots, fix real findings, and report when it is green. Use when asked to monitor, watch or babysit a PR.
- skills/file-pr [link]: File a short pull request that leads with the problem rather than an inventory of changes. Use when asked to file, open or create a PR.
- skills/full-send [link]: Take a change all the way to a merged PR unattended: prove it, review it, file it, babysit it, merge it. Use when the user says 'full send'.

stack search -- --kind searches for the literal text --kind.

show

stack show <id> [--file <path>] [--manifest]

Shows the manifest, files, usage and entry doc for one entry. The id is the path under the kind folder: skills/file-pr, components/base/button.

  • --file <path> prints one file of the entry. Text files print as text. Binary files print an error. With --json, images come back as base64, and other binary files report binary: true with no content.
  • --manifest adds the raw stack.json (human layout only; plain output always includes it).
  • A library id, such as components/dithercn, shows the library and its member components instead of one entry.
$ stack show skills/file-pr --file LICENSE | head -2
MIT License

Remote library members work the same way; their files are read from the cache.

path

stack path <id>
cd "$(stack path workers/mel)"

Prints the absolute path of an entry. For a remote library member it prints the cache directory of the whole library, not the member's folder.

See also: CLI Quick Tour, CLI Output Modes, CLI Remote Libraries.

Clone this wiki locally