CLI Reference#

gmuse msg#

Generate a commit message from staged changes.

$ gmuse msg [OPTIONS]

Options#

--hint TEXT / -h TEXT: Provide a hint to the LLM (e.g., “security fix”).
--format TEXT / -f TEXT: Message format: freeform (default), conventional, or gitmoji.
--model TEXT / -m TEXT: LLM model to use (overrides env/config).
--history-depth INTEGER: Number of recent commits to use for style context (0–50).
--copy / -c: Copy the generated message to clipboard.
--dry-run: Print the assembled prompt without calling the LLM provider.

Note: Provider selection is auto-detected from configured API keys (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY). See Configuration Reference for details on provider detection.

Dry-run example#

$ gmuse msg --dry-run

Output:

MODEL: gpt-4o-mini
FORMAT: freeform
TRUNCATED: false

SYSTEM PROMPT:
...

USER PROMPT:
...

Useful for debugging, auditing, or inspecting the prompt before calling the LLM.

gmuse info#

Display resolved configuration for debugging.

$ gmuse info

gmuse git-completions#

Generate shell completion scripts.

$ gmuse git-completions zsh