shipit

auto-generate and ship git commits with ai. never write a commit message again.

install

npm install -g shipitai

setup

before using shipit, configure your openrouter api key:

shipit config set

you'll be prompted for your api key and model preference. it's stored locally in ~/.shipit.

alternatively, set individual config values directly:

# set just the api key
shipit config set --apiKey your-key-here

# set just the model
shipit config set --model x-ai/grok-4.1-fast:free

# set both at once
shipit config set --apiKey your-key --model your-model

usage

auto-commit

automatically generate a commit message based on your staged changes:

shipit

this will show you the ai-generated commit message, then automatically commits and pushes.

manage config

view your current configuration:

shipit config get

reset your configuration:

shipit config reset

view config file location:

shipit config path

what it does

1. looks at your staged git changes
2. sends them to openai's api to generate a commit message
3. pushes that commit with the generated messages automatically

requirements

• git repository initialized
• openrouter key (get one at https://openrouter.ai/settings/keys)

license

MIT