Getting Started Free

Generate release notes with Cullit's template engine — no API key or credit card required.

Installation

Get Cullit up and running in seconds:

# Option 1: Run without installing (recommended)
npx cullit generate --from HEAD~10 --provider none

# Option 2: Install globally
npm install -g cullit
cullit generate --from HEAD~10 --provider none

# Option 3: Install with pnpm
pnpm add -g cullit

The free tier uses a built-in template engine—no AI model or API key needed. Perfect for getting familiar with Cullit before exploring AI-powered features.

Your First Run

Navigate to any Git repository and run:

# Generate from the last 10 commits (template-based)
cullit generate --from HEAD~10

# Generate between two tags
cullit generate --from v1.0.0 --to v1.1.0

# Auto-detect: uses the two most recent tags
cullit generate

Cullit collects your commits and formats them into clean, categorized release notes using the template engine.

What's Free

The free tier includes everything you need to generate and publish templated release notes:

Feature	Free	Paid Tiers
Template Engine (`--provider none`)	✅	✅
Publish to stdout & files	✅	✅
CLI commands: generate, status, tags	✅	✅
Custom categories & formatting	✅	✅
Jira / Linear enrichment	❌	✅ (Pro+)
AI generation (Claude, GPT, Gemini)	❌	✅ (Pro+)
Web Dashboard	❌	✅ (Pro+)
GitHub App (AI mode)	❌	✅ (Pro+)
Slack / Discord / Teams publishing	❌	✅ (Pro+)

Template Engine

The free template engine provides structured, categorized release notes based on commit messages and metadata. Create a .cullit.yml file in your project root to customize it:

# .cullit.yml

ai:
  provider: none              # Use the template engine
  audience: developer       # developer | end-user | executive
  categories:
    - features
    - fixes
    - breaking

publish:
  - type: stdout          # Print to terminal
  - type: file
    path: RELEASE_NOTES.md  # Save to file

Then generate notes:

cullit generate --from v1.0.0 --to v1.1.0

Commit messages are parsed by type prefix: feat: (features), fix: (fixes), BREAKING: (breaking changes). This follows conventional commits.

CLI Commands

cullit generate

Generate release notes between two refs:

cullit generate --from v1.0.0 --to HEAD

Options:

--from <ref>           Starting commit/tag
--to <ref>             Ending commit/tag (default: HEAD)
--provider none         Use template engine (free)
--format markdown|json  Output format

cullit status

Check account status and remaining generations:

cullit status

cullit tags

List available tags in your repository:

cullit tags

cullit init

Create a .cullit.yml interactively:

cullit init

Publishing Options (Free)

stdout (Terminal)

Print release notes to your terminal:

cullit generate --from v1.0.0 --to v1.1.0

Save to File

Write release notes to a Markdown or JSON file:

publish:
  - type: file
    path: CHANGELOG.md
    format: markdown

Then run:

cullit generate

Upgrade Benefits

The free tier is perfect for getting started. When you're ready to unlock AI-powered features:

Pro ($9/mo)

✅ 500 generations per month
✅ AI providers: Claude, GPT, Gemini, Ollama
✅ Jira / Linear enrichment
✅ 100 projects
✅ Slack, Discord, GitHub Release publishing
✅ Web Dashboard

Team ($19/seat/mo)

✅ Everything in Pro
✅ 2,000 generations/month
✅ Up to 10 team seats
✅ 250 projects
✅ Confluence, Notion, Teams publishing
✅ Hosted changelog pages
✅ White-label embed widgets

Enterprise (Custom)

✅ Unlimited generations
✅ Multi-repo aggregation
✅ SSO / SAML authentication
✅ On-premises / self-hosted
✅ Dedicated support & SLA
✅ Custom integrations

Ready to upgrade? Visit our pricing page or email sales@cullit.io

Full Documentation

Want to dive deeper? Check out the full documentation for:

✓ Complete configuration reference
✓ Advanced usage patterns
✓ GitHub Action setup
✓ Real-world examples
✓ API reference
✓ Team dashboard guide

Need help? Check out the interactive tutorial, browse GitHub, or email support@cullit.io.