miyamura80-cli-template 0.1.0

🪛 CLI tool template (python) with batteries included. Auto-install, updates, linting, dead code analysis, and a whole lot more.

cli-template

Batteries-included Python CLI template. Auto-discovery commands, global flags, output formatting, self-update, and a whole lot more.

Key Features • Quick Start • CLI Usage • Adding Commands • Configuration • Credits • About the Core Contributors

---

Key Features

Opinionated Python CLI template for fast development. The saas branch extends main with web framework, auth, and payments.

Feature	main	saas
Auto-discovery command system	✅	✅
Interactive fallback prompts	✅	✅
Shell completions	✅	✅
Self-update	✅	✅
Anonymous telemetry with opt-out	✅	✅
UV + Pydantic config	✅	✅
CI/Linters (Ruff, Vulture)	✅	✅
Pre-commit hooks (prek)	✅	✅
LLM (DSPY + LangFuse Observability)	✅	✅
FastAPI + Uvicorn	❌	✅
SQLAlchemy + Alembic	❌	✅
Auth (WorkOS + API keys)	❌	✅
Payments (Stripe)	❌	✅
Ralph Wiggum Agent Loop	✅	✅

Full comparison

Quick Start

make onboard              # interactive setup (rename, deps, env, hooks)
uv sync                   # install deps
uv run mycli --help       # see all commands
uv run mycli greet Alice  # run a command
uv run mycli init my_command  # scaffold a new command

CLI Usage

Global flags go before the subcommand:

Flag	Short	Description
--verbose	-v	Increase output verbosity
--quiet	-q	Suppress non-essential output
--debug		Show full tracebacks on error
--format	-f	Output format: table, json, plain
--dry-run		Preview actions without executing
--version	-V	Print version and exit

uv run mycli --format json config show     # JSON output
uv run mycli --dry-run greet Bob           # preview without executing
uv run mycli --verbose greet Alice         # detailed output

Adding Commands

Drop a Python file in commands/ and it is auto-discovered.

Single command - export a main() function:

# commands/hello.py
from typing import Annotated
import typer

def main(name: Annotated[str, typer.Argument(help="Who to greet.")]) -> None:
    """Say hello."""
    typer.echo(f"Hello, {name}!")

uv run mycli hello World   # Hello, World!

Subcommand group - export app = typer.Typer():

# commands/db.py
import typer

app = typer.Typer()

@app.command()
def migrate() -> None:
    """Run migrations."""
    ...

uv run mycli db migrate

Or scaffold with: uv run mycli init my_command --desc "Does something".

Configuration

from common import global_config

# Access config values from common/global_config.yaml
global_config.example_parent.example_child

# Access secrets from .env
global_config.OPENAI_API_KEY

CLI config inspection:

uv run mycli config show                           # full config
uv run mycli config get llm_config.cache_enabled   # single value
uv run mycli config set logging.verbose false      # write override

Full configuration docs

Credits

This software uses the following tools:

• Cursor: The AI Code Editor
• uv
• Typer: CLI framework
• Rich: Terminal formatting
• prek: Rust-based pre-commit framework
• DSPY: Pytorch for LLM Inference
• LangFuse: LLM Observability Tool

About the Core Contributors

Made with contrib.rocks.