0.0.0
AI-powered git workflow

Your Git workflow,
quietly smarter.

Generate thoughtful commit messages, switch AI providers, and push your work without leaving the terminal.

$npm install -g pushai
&&pai setup
~/repo pai commit

✦ running npx pushai commit - 0.0.0

✔ provider gemini [gemini-3.5-flash]

✔ staged diff read 1 file

✔ committing to main

✔ message generated

feat(ui): improve terminal output spacing

Improve spacing between terminal elements to make the output easier to read.

✔ how would you like to proceed? commit & push

✔ committed 5640ffd

✔ successfully pushed changes

✔ commit created and pushed to main.

npm version0.0.0
total downloads0
GitHub commits0

Workflow

How it works

From changed files to a finished commit, without leaving your terminal.

pai setup

Choose a provider and configure your AI.

~/repo pai setup

» pai setup

✔ provider ready byok / local

pai commit

Review changes and generate message.

~/repo pai commit

» pai commit

✔ message generated feat: add search

pai push

Push your changes to the remote repository.

~/repo pai push

» pai push

✔ pushed to origin/main

Features

Everything you need, nothing you don't

The essentials, handled carefully.

Conventional commits

Context-aware messages that follow the conventional commits format.

Review before you commit

Accept, edit, or regenerate every message.

Dry run

--dry-run previews the message without committing.

Conflict check

Stops and lists unresolved conflicting files before anything happens.

Multiple providers

Configure several and hop between them with pai switch.

Secure by default

Keys live in your OS keychain, with a permission-locked fallback. Config never contains secrets.

Bring your own model

Your model, your rules

Choose the service that fits, or keep everything on your machine.

01 / CLOUD

Bring Your Own API Key

Keys are validated live before they're saved.

AnthropicOpenAIGeminiHugging Face

02 / LOCAL

Run AI locally

Use Ollama to run models locally.

Ollama
Managed modeComing soonNo key required.

Commands

Seven commands. That's the whole tool.

Small enough to remember, useful enough to stay in your workflow.

pai setup

Choose a provider and configure your key or local model.

~/repo pai setup

» pai setup

✔ selected mode byok

✔ provider ready anthropic

Trust

Your code stays yours.

Your setup is yours to control.

  • ✔Local mode runs via Ollama.
  • ✔Keys are stored in your OS keychain.
  • ✔MIT licensed and open source.
~/.config/pushai/config.json
{
  "activeProvider": "ollama",
  "model": "local-model"
}

// no keys in config

FAQ

Good to know

A few practical details before you start.