workflow-tools

The installable ticket/spec/session/rule/audit/test CLI and MCP bundle that context-engine and downstream consumers depend on. Its primary use case is bootstrapping a consumer workspace with the ticket and spec CLIs so agents and humans can track work as structured tickets instead of ad hoc markdown notes.

Quickstart: bootstrap a consumer

Install the minimal ticket/spec CLI bundle and initialize one consumer workspace with a single, version-pinned command:

bash bootstrap.sh \
	--root "$HOME/.local/workflow-tools" \
	--workspace /path/to/minimal-demo

The bootstrap command installs only into the supplied --root and initializes only the supplied --workspace. It never discovers a sibling consumer from a superproject working directory. Use --dry-run to inspect the pinned install commands before modifying a consumer workspace.

workflow-minimal-demo is the first top-level consumer workspace in the meta-workspace and exercises this install path.

Installation Registry

install/artifacts.toml is the canonical inventory of workflow-tools source artifacts. Each source_path is relative to this repository root. The install/install-ctl crate reads the registry at runtime and generates COMMANDS.md:

cargo run --manifest-path install/install-ctl/Cargo.toml -- catalog --check

Public Install Entry Point

install.sh is the single curl | bash entry point. It installs install-ctl into a caller-supplied local directory (never a system-wide bin path) from the install repository, then hands off to it:

curl -fsSL https://raw.githubusercontent.com/mankinskin/install/main/install.sh \
  | bash -s -- --root "$HOME/.local/workflow-tools"

Use --dry-run to preview the pinned cargo install command, or append -- <install-ctl args> to run install-ctl immediately after installing it (for example -- --list).

To uninstall install-ctl or any installed artifacts, pass --uninstall to install.sh or use install-ctl's uninstall commands:

# Shell-level self-removal:
bash install.sh --root "$HOME/.local/workflow-tools" --uninstall

# CLI-level uninstallation:
install-ctl uninstall <selection>
install-ctl self-uninstall
install-ctl guidance uninstall --source <repo> --profile <profile.toml> --select <id>...

Guidance Corpus Installer

install-ctl guidance plan|install|autofix|get plans, fetches, installs, and repairs guidance corpora (.agents/**) across repo/user/system/explicit destinations. See install/README.md for the full command contract, profile schema, dependency/diagnostic classes, and the deterministic fixture/Docker validation commands.