$ recombobulate _
home / tips / write-python-click-cli-tools-with-claude
258

Write Python Click CLI Tools with Claude

recombobulate @recombobulate · Mar 26, 2026 · Workflows
write-python-click-cli-tools-with-claude

Click is Python's go-to library for building command-line tools, but getting the arguments, types, validation, and help text all right takes longer than it should. Claude can write a complete, production-ready CLI in one prompt.

Describe what you need:

Write a Python Click CLI tool that:
- Has a main command group called "db"
- Has a subcommand "export" that takes --format (csv or json), --output path, and --table name
- Has a subcommand "import" that takes a file path and --dry-run flag
- Validates that the output path's parent directory exists
- Shows a progress bar using Click's progressbar utility
- Has full --help output with examples

Claude will scaffold the full module with a proper if __name__ == "__main__" guard, type annotations, error handling with click.ClickException, and a pyproject.toml [project.scripts] entry so you can install it as a real CLI command.

For adding new subcommands to an existing CLI:

Add a "stats" subcommand to @cli/main.py that accepts an optional --since date 
argument (default: 7 days ago) and outputs a summary table using Click's echo formatting.

A Click CLI is only two dozen lines to get wrong and two hundred to get right — describing what you want is faster than reading the docs.

~/recombobulate $ tip --comments --count=0

Log in to leave a comment.

~/recombobulate $ tip --related --limit=3
0
Run Claude Code in GitHub Actions to Automatically Review Every Pull Request

Set up Claude Code as an automated reviewer in your CI pipeline — on every pull request, it reads the diff, checks for bugs, security issues, missing tests, and convention violations, then posts its findings as a PR comment. Your human reviewers get a head start because the obvious issues are already flagged before they look.

recombobulate @recombobulate · 1 month ago
0
Ask Claude to Build a Deployment Checklist from Your Actual Infrastructure

Before deploying, tell Claude to read your project — migrations, environment variables, queue workers, scheduled tasks, caching, third-party integrations — and generate a deployment checklist that's specific to your app. Not a generic "did you run migrations?" list, but one that knows YOUR infrastructure and catches the things YOUR deploy can break.

recombobulate @recombobulate · 1 month ago
0
Ask Claude to Generate a README from Your Actual Codebase — Not a Template

Instead of writing a README from memory or copying a template, tell Claude to read your project and generate one that's actually accurate — real setup instructions from your config, real architecture from your directory structure, real API examples from your routes, and real prerequisites from your dependency files.

recombobulate @recombobulate · 1 month ago