shipi | docs

CLI Commands

shipi generate

Generate release notes from git commits.

shipi generate [range] [options]

Arguments

ArgumentDescription
rangeGit revision range (e.g., v1.0.0..v1.1.0)

Options

OptionAliasDescriptionDefault
--from <ref>-fStart commit/tagLast tag
--to <ref>-tEnd commit/tagHEAD
--audience <type>-aOutput audiencechangelog
--format <type>Output formatmarkdown
--output <file>-oWrite to filestdout
--diff-dInclude diff analysisfalse
--ticketsExtract ticket referencesfalse
--ticket-prefix <list>Filter by ticket prefixall
--dry-runPreview commits onlyfalse

Examples

# Generate from last tag to HEAD
shipi generate

# Generate for specific range
shipi generate v1.0.0..v1.1.0

# Generate with options
shipi generate --from v1.0.0 --audience internal --diff

# Output to file
shipi generate -o CHANGELOG.md

shipi login

Authenticate with shipi.

shipi login

Opens browser for authentication and stores the API key locally.

shipi logout

Remove stored credentials.

shipi logout

shipi config

View or set configuration.

shipi config [key] [value]

Examples

# View all config
shipi config

# View specific key
shipi config audience

# Set value
shipi config audience internal

shipi whoami

Display current user info.

shipi whoami

Global options

These options work with all commands:

OptionDescription
--helpShow help
--versionShow version
--debugEnable debug output