@clogg/cli

CLI for clogg.one — manage changelogs from the terminal.

Authenticate once, then create, publish, and sync changelogs without leaving your terminal. Zero token overhead compared to MCP.

Install

npm install -g @clogg/cli

Or use without installing:

npx @clogg/cli login

Authentication

clogg login     # opens browser for GitHub OAuth
clogg whoami    # show current user and token expiry
clogg logout    # clear stored credentials

Credentials are stored in ~/.config/clogg/credentials.json with 365-day expiry.

Commands

Projects

# List all projects
clogg project list

# Create a manual project
clogg project create --name="My App" --slug=my-app

# Create a project linked to a GitHub repository
clogg project create --name="My App" --slug=my-app --github=owner/repo

Changelogs

# List changelogs for a project
clogg changelog list --project=my-app

# Add a changelog with inline content
clogg add --project=my-app --version=1.2.3 --content="## Bug Fixes\n- Fixed login issue"

# Add a changelog from a file
clogg add --project=my-app --version=1.2.3 --file=CHANGELOG.md --title="March Release"

# Publish / unpublish
clogg publish --project=my-app --version=1.2.3
clogg unpublish --project=my-app --version=1.2.3

GitHub Sync

# Sync releases from GitHub and generate changelogs with AI
clogg sync --project=my-app

# Regenerate AI content for a specific version
clogg generate --project=my-app --version=1.2.3

CLI vs MCP

| | CLI | MCP | |---|---|---| | Token cost | Zero per-message overhead | ~1,500 tokens/message | | Auth | One-time login, 365-day token | Re-auth on token expiry | | Usage | Direct terminal commands | Natural language via Claude | | Best for | CI/CD, scripts, quick actions | Conversational workflows |

Both use the same API endpoints and can be used interchangeably.

All Options

Usage: clogg [command] [options]

Commands:
  login                          Authenticate with clogg.one
  logout                         Clear stored credentials
  whoami                         Show current user and token info
  project list                   List all projects
  project create [options]       Create a new project
  changelog list [options]       List changelogs for a project
  add [options]                  Add a new changelog entry
  publish [options]              Publish a changelog entry
  unpublish [options]            Unpublish a changelog entry
  sync [options]                 Sync GitHub releases for a project
  generate [options]             Regenerate AI content for a changelog

Run clogg <command> --help for detailed options on any command.

Requirements

• Node.js 18+
• A clogg.one account (GitHub login)

License

MIT