Cmdr

A fast, developer-friendly CLI for bootstrapping microservices and handy Go tools.

Table of Contents

• Project Profiles (Smart Detection)

Usage

Cmdr helps you run tasks like migrations, dev servers, and more.

# Show help
cmdr --help

Example Command: ask

The ask command allows you to send a question to an API (e.g., Gemini API) and get an immediate response.

cmdr ask -q "test"

Output:

Response: Okay, I'm here! What would you like me to do?

Example Command: crypto

The crypto command provides cryptographic utilities including file encryption (AES-GCM / Argon2id), key generation, and random data creation.

# Generate a secure 20-character password
cmdr crypto r -t p -l 20

# Generate a 32-byte AES key (HEX/Base64)
cmdr crypto r -t a -l 32

# Encrypt a file using a password (Argon2id + AES-GCM)
cmdr crypto pass-encrypt -f secret.txt -p MyPassword123

# Decrypt a file encrypted with Argon2id
cmdr crypto pass-decrypt -f encrypted/secret.txt.enc -p MyPassword123

Configuration File

When you first run the ask command, a .config.json file will be generated in the same directory as the executable. This file will look like this:

{
  "gemini": {
    "url": "[https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent](https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent)",
    "apiKey": "your_gemini_api_key_here"
  }
}

Other Available Commands

Cmdr provides several commands to help with your Go and microservices tasks. Here’s a list of available commands:

cmdr helps you run tasks like migrate, dev server, etc.

Usage:
  cmdr [flags]
  cmdr [command]

Available Commands:
  ask             Ask questions to an API and get the answer
  clear           Deletes all directories with the given name in the current project
  completion      Generate the autocompletion script for the specified shell
  create-service  Create a new microservice from a template
  crypto          Cryptographic operations: keys, encryption, random data, hashing
  files-combine   Combine contents of files with chosen extensions into one file
  hello           Say hello
  help            Help about any command
  info            Show recommended Go project structure and common use cases
  killport        Find and optionally kill the process using a port
  killprocess     Find and optionally kill processes by name
  remove-comments Remove comments from a specific file or all files in a directory
  tree            Display a tree view of folders and files
  version         Shows the CLI version

Flags:
  -h, --help   help for cmdr

Use "cmdr [command] --help" for more information about a command.

Flags

• -h, --help: Display help for the cmdr command or any individual command.