Skip to main content
Workflow packs install read-only workflows and their UIs under .smithers/packs/<name>. Pack workflows are visible to workflow list and can be run with either their unqualified id or an explicit <pack>:<workflow> id.

Eject a workflow

Copy a pack workflow into the local .smithers/ tree when you want to edit it:
Smithers copies the workflow and its relative UI, prompt, library, stylesheet, and other imported assets. It refuses if any destination already exists. The local copy then shadows the pack copy automatically, so workflow run kanban uses the ejected workflow while workflow run kanban-suite:kanban still addresses the pack version.

Update packs

Pack updates are separate from the Smithers installation update command:
The first form refreshes one locked pack; the bare form refreshes every locked pack. Updates replace pack contents only. Ejected files live in the local .smithers/workflows, .smithers/ui, .smithers/prompts, and .smithers/lib directories and are left unchanged. Use these commands for the rest of the lifecycle:

Share a pack

Every initialized .smithers/ directory can be published as a pack. Set its repository in smithers.toon, then preview the awesome-smithers entry:
The normal command uses the authenticated gh CLI to fork the registry, update its Packs section, push a branch, and open a pull request. Use --repo owner/registry to override the registry repository. The seeded share-pack workflow performs the validation and repository preparation steps before calling this command.