Skip to content

Speck 0.1.0

Choose a tag to compare

@nicoten nicoten released this 10 Sep 12:52
· 23 commits to main since this release

First release. A desktop reader for OpenSpec projects.

Speck groups a project's documents by where each one sits in its declared
workflow schema, and numbers every document into a single reading sequence, so
a project can be read start to finish instead of by guessing which file comes
next.

  • Order comes from the schema, not from Speck. A project names its schema in
    openspec/config.yaml; that schema declares its artifacts, and the tree is
    built by walking it. A custom schema is read in its own order.
  • Gaps stay visible. An artifact the schema expects but nobody has written
    yet shows as a step not started, rather than being hidden.
  • Progress per change. Each change shows its steps as a stepper: a step
    counts as done only once work has moved past it, and the last step waits on
    its own checklist.
  • Structure-aware reading. Requirements and scenarios render as anchored
    blocks, delta operations are badged ADDED / MODIFIED / REMOVED / RENAMED, and
    tasks.md renders as a checklist.
  • Read-only by construction. No filesystem write capability, shell
    execution scoped to the openspec binary, and reads refused outside an open
    project.
  • Live. Projects are watched, so a file rewritten by an agent refreshes in
    place and keeps your scroll position.

Install

Download the .dmg, drag Speck to Applications. Signed with a Developer ID and
notarised, so it opens with a double-click. Apple Silicon only.

Speck reads projects through the openspec CLI when it is installed and falls
back to its own scanner when it is not, saying which in the top bar.

Later versions are offered in-app and verified against the release signature.