cli-tool-template
Installation
SKILL.md
Personal CLI tool template
Every tool is one repo at ~/code/<tool> and github.com/filipgutica/<tool>, released by release-please and installed with brew install filipgutica/tap/<tool>. The tools are consistent when each item below holds. Language, CI steps, and README body vary by tool.
Stack
Releases use release-please on every tool. Merged PRs accumulate in a release PR, and merging that release PR tags and publishes the version. That gives one review point before each release. semantic-release is not used: it publishes on every merge, with no release PR.
Pick the language by what the tool needs, then follow that row. The reference tool in each row is the live implementation to copy from.
| Language | Pick when | Reference | Build and CI | release-please release-type (version source) |
Formula |
|---|---|---|---|---|---|
| Rust | Interactive TUI, speed, or a native macOS bundle | annoterm | rust-toolchain.toml pin; cargo fmt --check, clippy -D warnings, test --locked |
rust (Cargo.toml) |
depends_on "rust" => :build; cargo install *std_cargo_args |
| TypeScript on Node | Git, GitHub, process, or JSON-heavy logic that wants npm packages and types | wtree, devps | npm with package-lock.json; npm ci, typecheck, test, build; Node 22 |
node (package.json) |
depends_on "node"; npm ci, npm run build, npm install *std_npm_args |