You are reading the documentation for v1.x, an older version.Read the latest (v2.x) →
Shemul CLI
A project-aware command line tool that centralizes repetitive development commands in a JSON file and runs them with safety controls.
Overview
Shemul is an advanced project-aware CLI tool for task automation based on JSON configuration. It is a free and open-source CLI that centralizes repetitive development commands in shemul.json and runs them with safety controls, supporting both project-local and user-global command scopes.
Key features
- Dual scope configuration: project and global config. A project command overrides a global command with the same name.
- Project discovery: the project is found through
shemul.json. - Variables and environments: commands support
varsandenvtemplating. - Safety controls:
confirm,danger,--dryand--trace. - Diagnostics:
shemul doctor, and a bundled JSON Schema forshemul.json(shemul schema). - Templates: built-in template-based initialization with
shemul init [template]. - Shell completion: scripts for bash, zsh and fish.
Requirements
- Python 3.9 or newer.
- Optional: shell completion (bash, zsh or fish) via the scripts in
completion/.
Release notes
Version 1.0.1 (March 20, 2026), patch: fixed the Python version requirement to 3.9 or higher across package metadata and docs.
Version 1.0.0 (February 11, 2026), initial release: project and global scope config, template-based init and safety controls.