#rlsbl

rlsbl is a release orchestration CLI that handles version bumping, structured JSONL changelogs, CI scaffolding, tagging, and GitHub Releases across 18 ecosystems. It supports single-target projects, multi-target projects, and monorepo workspaces with independent versioning.

#Getting started

Install rlsbl via uv tool install rlsbl (Python) or npx rlsbl (npm wrapper). Initialize a project with rlsbl scaffold to generate CI workflows, git hooks, and changelog infrastructure. See the README for full installation instructions and quick start examples. Key commands:

• rlsbl scaffold -- set up a new project
• rlsbl release run --watch --yes -- perform a release
• rlsbl status -- check current state

#Guides

• Release workflow -- end-to-end release process, bump types, release file format
• Changelog system -- JSONL entries, validation, coverage enforcement
• Scaffold and templates -- CI/CD generation, three-way merge, hooks
• Check system -- 50 diagnostic checks across 6 tags
• Deployment -- deploy targets, post-release hooks, Cloudflare Pages
• Development workflow -- editable installs, pre-push hook, local testing
• Utility commands -- status, discover, migrate, record-gif, and other helpers

#Architecture

• Import scanning -- tree-sitter-based dependency detection
• Dependency validation -- cross-project dependency checks
• Pipeline architecture -- publish pipeline types, asset uploads, configuration
• Layer enforcement -- architectural layer rules for monorepos
• Native mobile targets -- Android and iOS version bumping

#Reference

• Configuration -- .rlsbl/config.json format and all keys
• Release targets -- the 18 supported ecosystems
• Monorepo -- workspace management, subtree publishing, batch releases
• CI customization -- custom workflow files that survive scaffold
• CLI reference -- all commands and options (auto-generated)
• API reference -- module documentation (auto-generated)