Add Cli Options

Critical Patterns

Define Main Command

Use the main function to set up the entry point for your CLI application.

import click
from repoforge.cli import main

@main.command()
def my_command():
    click.echo("This is my command.")

Add Skills

Utilize the skills export to define reusable command options.

import click
from repoforge.cli import skills

@skills.option('--verbose', is_flag=True, help='Enable verbose output.')
def my_command(verbose):
    if verbose:
        click.echo("Verbose mode is on.")

When to Use

• When creating a new command for the CLI.
• To add common options across multiple commands.
• To streamline the execution of default commands.

Commands

python repoforge/cli.py my_command

Anti-Patterns

Don't: Hardcode Options

Hardcoding options reduces flexibility and reusability across commands.

# BAD
@click.command()
@click.option('--option', default='value', help='Hardcoded option.')
def my_command(option):
    click.echo(option)

Quick Reference

| Task | Pattern | |---------------------|------------------------| | Define a command | @main.command() | | Add shared options | @skills.option() |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: JNZader
• Source: JNZader/repoforge
• License: MIT
• Homepage: https://repoforge.javierzader.com

Install and usage instructions live in the source repository linked above.