Introducing Shemul v1.0.0 for PIP: Your Ultimate Task Runner

Shemul is a lightweight task runner that actually respects your workflow

Every developer knows the feeling. You open a project and instantly start typing the same commands again. Build, migrate, run, restart, test… repeat. Over time, those commands get scattered across shell history, README files, and half-remembered notes.

Shemul started from that exact frustration. Not to replace how you work, but to make daily development smoother and safer.

💡 Why Shemul Exists

Modern stacks are powerful, but everyday workflows often feel messy. One project uses Docker, another runs FastAPI, and another needs custom scripts just to start. You end up juggling commands instead of focusing on real development.

Shemul keeps things simple.

It is a lightweight, project-aware CLI that centralizes your repetitive commands inside a single shemul.json file. Instead of remembering long scripts, you run clean, readable commands from one place.

No heavy frameworks. No complicated setup. Just clarity.

🧩 What Makes Shemul Different

Shemul was built with a small but intentional philosophy: powerful enough to help, simple enough to trust.

Here is what that looks like in practice:

✨ Dual scope configuration
Commands can live inside your project or globally across your system.

🎯 Deterministic precedence
Project commands always override global ones, so nothing behaves unexpectedly.

🔎 Automatic project discovery
If a shemul.json exists, the CLI understands the context instantly.

🛡️ Safety first execution
Confirm prompts, danger warnings, dry runs, and trace mode help prevent mistakes.

🧱 Template-based initialization
Start new projects faster with built-in templates for common stacks.

📦 Rich CLI output
Commands are grouped, explained, and easy to explore.

The goal is not to force a new workflow. The goal is to organize the one you already have.

⚙️ How It Works

At the core of Shemul is a simple JSON configuration file where commands live.

Example:

{
  "$schema": "https://www.shemul.net/schema.json",
  "name": "example-project",
  "runtime": "docker",
  "commands": {
    "up": {
      "run": "docker compose up --build",
      "desc": "Start stack"
    }
  }
}

After that, your workflow becomes:

shemul up

Short. Predictable. Easy to remember.

🌍 Scope Model

Shemul supports two configuration scopes:

📁 Project scope /shemul.json

🌐 Global scope

Windows: %APPDATA%\Shemul\shemul.json
macOS: ~/Library/Application Support/Shemul/shemul.json
Linux: $XDG_CONFIG_HOME/shemul/shemul.json or ~/.config/shemul/shemul.json

If both scopes define the same command, the project version wins automatically.

✨ Features You Will Notice Immediately

• Dual scope project and global configs
• Template-driven initialization
• Env and variable templating
• Safety flags like confirm and danger
• Diagnostics via shemul doctor
• JSON schema validation
• Friendly help and suggestions
• Shell completion for bash, zsh, and fish

Everything is designed to feel familiar from the first run.

🛠️ Getting Started

Requirements:

Python 3.14 or higher

Install using pip:

pip install shemul

Initialize global config:

shemul init -g

Initialize a project:

shemul init fastapi-backend

List commands:

shemul ls

Run one:

shemul <command>

You can also preview execution safely using dry run and trace mode before running anything risky.

📦 Version 1.0.0 Highlights

This first release focuses on stability and strong fundamentals:

• Project and global configuration system
• Template-based initialization
• Built-in safety controls
• Diagnostics and schema validation

Instead of shipping dozens of experimental features, 1.0.0 focuses on reliability you can depend on daily.

🔐 Security and Open Source

Shemul is fully open source under the MIT License. Transparency and safety were core priorities from day one.

If you discover any security-related issues, please contact [e-mail] directly.

Contributions, ideas, and improvements are always welcome through GitHub.

🧭 What Comes Next

The roadmap is already moving forward:

• Plugin and extensibility system
• Community template registry
• Improved cross-platform UX
• Optional team shared configuration
• More diagnostics and command introspection

The vision is simple: give developers structure without slowing them down.

👨‍💻 About the Author

Md. Ashraful Alam Shemul created Shemul from real-world development experience, where repetitive commands kept getting in the way of progress.

🌏 About S Technologies

Shemul is published by S Technologies, a research-focused technology company in Bangladesh, founded in 2013. The company works across AI research, software development, SaaS platforms, infrastructure, and open source innovation.

💬 Final Thoughts

Shemul 1.0.0 is not about reinventing development tools. It is about removing friction.

One config file.
One clean CLI.
One place for your workflow.

If your projects feel cluttered with scripts and repeated commands, Shemul might be the small tool that makes a big difference.