Installation

SpecLeft is a Python CLI and pytest plugin. It is safe by default and does not write files unless you explicitly ask it to.

Prerequisites

• Python 3.10+
• A Git repository (recommended)
• pytest (only required when you run tests)

Install the CLI

Install from PyPI:

pip install specleft

Verify the install:

specleft doctor

Initialize (optional)

If you want a sample spec to explore the format, run this at the repo root:

specleft init

This creates a .specleft/specs/ directory with a simple example file.

First safety check

SpecLeft is passive by default. You can preview any write operation before committing to it:

specleft plan --dry-run