usage

name	usage
description	How to use the CLI interface. Use this skill when interacting with the tool as an end user.

Usage Guide

This skill teaches you how to use the CLI interface provided by this project.

CLI

Installation

pip install miyamura80-cli-template

Or install from source:

git clone https://github.com/Miyamura80/CLI-Template.git
cd CLI-Template
uv sync

Basic Usage

# Show help and all available commands
uv run mycli --help

# Run a command
uv run mycli greet Alice

# Scaffold a new command
uv run mycli init my_command --desc "Does something"

Global Flags

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

Examples

# JSON output
uv run mycli --format json config show

# Preview without executing
uv run mycli --dry-run greet Bob

# Detailed output
uv run mycli --verbose greet Alice

# Manage configuration
uv run mycli config show
uv run mycli config get llm_config.cache_enabled
uv run mycli config set logging.verbose false

Shell Completions

# Install completions for your shell
uv run mycli --install-completion

# Show completion script
uv run mycli --show-completion