1. Create an Account

Visit Cmarta Commit and create an account.

2. Generate an API Key

1. Log into your dashboard
2. Navigate to the "API Keys" section
3. Click "Generate New Key"
4. Copy and save your API key (you won't be able to see it again)

3. Configure the CLI Tool

cmarta-commit setup

Enter your API key when prompted. The key will be securely stored in your home directory.

Generate AI-Powered Commit Messages

Navigate to your git repository and stage your changes:

git add .
cmarta-commit

Or stage and commit in one command:

cmarta-commit -a

Interactive Flow

After running the command, you'll see:

🤖 Generating commit message...

✨ Generated commit message:
"feat(auth): implement two-factor authentication"

? What would you like to do?
❯ Commit with this message
  Edit the message
  Generate a new message

  Cancel

Command Options

• Commit with this message: Uses the AI-generated message as-is
• Edit the message: Opens an editor to modify the message
• Generate a new message: Creates a new AI-generated message
• Cancel: Exits without committing

Core Commands

# Setup API key
cmarta-commit setup

# Generate and commit (interactive)
cmarta-commit

# Auto-stage and generate commit
cmarta-commit -a
cmarta-commit --all

# Auto-commit without confirmation
cmarta-commit -y
cmarta-commit --auto

# Combine options
cmarta-commit -a -y

Help and Information

# Show version
cmarta-commit --version

# Show help
cmarta-commit --help

Config File Location

The CLI stores configuration in:

• Linux/macOS: ~/.cmarta-commit-config.json
• Windows: %USERPROFILE%\.cmarta-commit-config.json

Config Structure

{
  "apiKey": "sk_your_api_key_here"
}

Updating Configuration

Re-run setup to update your API key:

cmarta-commit setup

Common Issues

git init

# Stage your changes first
git add .
# Or use the auto-stage flag
cmarta-commit -a

cmarta-commit setup

Understanding Usage Limits

Optimizing Usage