Skip to content

Penify-CLI Documentation

Penify CLI is a tool that enhances your development workflow with AI-powered capabilities:

  • Generate smart commit messages using local LLM models or cloud API
  • Automatically create code documentation
  • Integrate with JIRA for enhanced commit messages
  • Install Git hooks for automated documentation generation

Installation

bash
pip install penify

Authentication

Penify CLI supports two authentication methods:

1. Login to Penify Account (Required for Advanced Features)

bash
penify login

This command will open your browser and prompt you to log in to your Penify account. Once authenticated, your API token will be saved locally.

2. Environment Variable

For CI/CD pipelines or automated environments, you can set:

bash
export PENIFY_API_TOKEN=your_api_token

Basic Usage

Generate Smart Commit Messages

bash
penify commit

Generate Code Documentation

bash
# Generate documentation for current Git diff (requires login)
penify docgen

# Generate documentation for a specific file
penify docgen -l path/to/file.py

# Generate documentation for a folder
penify docgen -l path/to/folder

Configure Local LLM or JIRA

bash
# Configure Local LLM for commit message generation
penify config llm

# Configure JIRA integration
penify config jira

Automate Documentation with Git Hooks

bash
# Install a post-commit hook
penify docgen install-hook

# Remove the hook
penify docgen uninstall-hook

Getting Help

bash
# Get general help
penify --help

# Get help for a specific command
penify commit --help
penify docgen --help
penify config --help

For detailed documentation and examples, see docs/detailed-usage.md.