scissors 0.0.1

Editor-based content approval, git-commit style
scissors-0.0.1 is not a library.
Visit the last successful build: scissors-0.2.0

scissors

crates.io PyPI License: MIT OR Apache-2.0

scissors is a Unix CLI primitive for editor-based content approval, modelled on git's commit.cleanup=scissors convention. It opens content in your editor and returns the approved bytes on stdout.

What it will do (v0.1.0)

# Approve a PR body before submission
gh pr view 42 --json body --jq .body | scissors > approved.md

# Edit and confirm a draft, with context for multi-draft sessions
echo "$DRAFT" | scissors --context "Issue #26 reply" > /tmp/out
  • Opens stdin in your $VISUAL / $EDITOR (or vi as fallback)
  • Strips everything below the scissors line (# ----- >8 -----)
  • Exit code signals status: 0 approved, 1 aborted, 2 error
  • Returns approved content on stdout — composable in pipelines

Roadmap

  • 0.0.1 (this release) — name reservation, working --help and --version
  • 0.1.0 (next) — full implementation: stdin -> editor -> stdout, exit codes for status, --context flag
  • Future — --json flag for structured output, additional editor integrations

Install (once 0.1.0 ships)

# Via PyPI
pip install scissors

# Via uv
uv tool install scissors

# Via Cargo
cargo install scissors

# Via Homebrew (planned)
brew install ggueret/scissors/scissors