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

git add .
dash commit

dash pr

Commands

Commit

dash commit

dash commit --all
dash commit --generate 3
dash commit --exclude dist/
dash commit --type conventional

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 llama-3.3-70b-versatile

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=llama-3.3-70b-versatile
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