Specline canon 2.3.0-draft Handbook For agents ↗
Doctor · Install

Install

The CLI is specline; doctor is its validate verb. doctor is TypeScript that runs on Node directly — no build step, no dependencies.

Requirements

  • Node 22+ — Node strips TypeScript types natively, so the source runs as-is.
  • That's it. No Bun, no npm install, no runtime to set up.

Today: from the repo

Clone the doctor repo and run it directly:

shell
# clone
git clone https://github.com/speclinedev/cli
cd cli

# run against any repo
node src/cli/index.ts ~/path/to/repo --format human

Put specline on your PATH

A two-line wrapper makes specline work from any directory:

~/.local/bin/specline
#!/bin/sh
exec node /abs/path/to/cli/src/cli/index.ts "$@"

Then chmod +x ~/.local/bin/specline (ensure ~/.local/bin is on your PATH). The canon path resolves relative to the source, so it works from anywhere.

Coming: published distribution

Not yet published — the planned, version-pinned forms are:

  • npmnpx @specline/cli doctor <repo>, or npm i -g @specline/cli. The package version tracks the canon version (@specline/cli@2.3 ↔ canon 2.3).
  • Standalone binarybun build --compile produces a single dependency-free specline executable for the no-Node case.

Verify

shell
specline doctor .          # validate the current repo
specline rules             # list the rule catalog
specline spec | head       # print the pinned canon

Next: the CLI reference, or wire it in as an MCP tool.