Dash

AI-powered Git CLI. Generate commit messages, create PRs, manage issues—all from your terminal.

Install

npm install -g dash-git

Linux users: If dash runs the system shell instead of this CLI, use dash-cli instead.

Setup

Get your free API key from console.groq.com/keys:

dash config set GROQ_API_KEY=gsk_your_key_here

Or use an environment variable:

export GROQ_API_KEY=gsk_your_key_here

Quick start

dash

dash commit
dash c -m "chore: hide testimonials"

dash pr

Commands

Commit

dash commit
dash c

dash commit --all
dash commit -m "chore: hide testimonials"
dash commit --generate 3
dash commit --exclude dist/
dash commit --type conventional

dash now opens a staging selector before committing. "Stage all changed files" is selected by default, and you can switch to manual mode with the arrow keys to pick files with Space and submit with Enter.

dash commit still works with already staged files. If nothing is staged, dash asks whether to stage everything or select files manually before it generates the message.

For larger diffs, dash can now generate a multi-line commit message with a normal type: subject line followed by - bullet points for the main changes.

Pull requests

Requires GitHub CLI.

dash pr
dash pr --draft
dash pr --base develop

dash pr list
dash pr view
dash pr merge --squash

Issues

dash issue list
dash issue list --state all
dash issue list --limit 10

Model

dash model
dash model list
dash model set openai/gpt-oss-120b

Change AI models interactively or directly. See all models at console.groq.com/docs/models.

Git hook

dash hook install
dash hook uninstall

Then git commit auto-generates messages.

Configuration

Config lives in ~/.dash:

dash config set <key>=<value>
dash config get <key>

Option	Default	Description
GROQ_API_KEY	-	API key (required)
model	openai/gpt-oss-20b	AI model
generate	1	Messages to generate
type	-	Use conventional
max-length	100	Max message length
locale	en	Message language

Examples:

dash config set model=openai/gpt-oss-120b
dash config set type=conventional max-length=72

Custom prompts

Create a .dash folder in your repo with custom guidelines:

.dash/commit.md - Commit rules:

Use present tense. Include ticket numbers.

.dash/pr.md - PR rules:

Include testing steps and related tickets.

Dash uses these instead of default prompts. Works with monorepos—searches up the tree to find the nearest .dash folder.

Documentation

Full docs at koushikxd.github.io/dash-git

Requirements

• Node.js 18+
• Git
• GitHub CLI (for PR/issue commands)

Acknowledgments

Inspired by noto by Sithija Nelusha Silva.

License

MIT