Dash CLI

AI-powered Git CLI for commit messages, PRs, and GitHub workflows.

Install

``bash
npm install -g @koushik_xd/dash
`

Then run:

`bash
dash setup
`

> Note: If you have the system shell dash installed (common on Debian/Ubuntu), use dash-cli instead of dash for all commands.

Requirements

- Node.js 18+
- Git
- Groq API Key from console.groq.com/keys
- GitHub CLI (optional) - for PR/issue commands. Get it at cli.github.com

Quick start

`bash
dash config set GROQ_API_KEY=gsk_your_key_here

dash setup

git add .
dash commit

dash pr
`

Commands

$3

`bash
dash commit [-g ] [-x ] [-a] [-t ]
`

| Flag | Description |
| ----------------------- | ---------------------------- |
| -g, --generate | Generate n messages (max: 5) |
| -x, --exclude | Exclude files |
| -a, --all | Stage all tracked files |
| -t, --type | Use conventional format |

Examples:

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

$3

`bash
dash pr [create|list|view|merge] [flags]
`

| Subcommand | Description |
| ---------- | ---------------- |
| create | Create/edit PR |
| list | List open PRs |
| view | View current PR |
| merge | Merge current PR |

Create flags:

| Flag | Description |
| --------------------- | --------------- |
| -b, --base | Base branch |
| -d, --draft | Create as draft |

Merge flags:

| Flag | Description |
| -------------- | ------------ |
| -s, --squash | Squash merge |
| -m, --merge | Merge commit |
| -r, --rebase | Rebase merge |

Examples:

`bash
dash pr
dash pr --draft --base develop
dash pr list
dash pr merge --squash
`

$3

`bash
dash issue list [-s ] [-l ]
`

| Flag | Description |
| --------------------- | ------------------------ |
| -s, --state | open, closed, all |
| -l, --limit | Max issues (default: 20) |

Examples:

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

$3

`bash
dash config
`

Examples:

`bash
dash config set GROQ_API_KEY=gsk_xxx
dash config set model=llama-3.3-70b-versatile
dash config get GROQ_API_KEY model
`

$3

`bash
dash hook
`

Installs git hook for auto-message generation.

$3

`bash
dash setup
`

Checks dependencies and configures GitHub CLI integration.

Configuration

Config stored in ~/.dash:

| Option | Default | Description |
| -------------- | ------------------ | ------------------ |
| GROQ_API_KEY | - | API key (required) |
| model | openai/gpt-oss-20b | AI model |
| generate | 1 | Commit suggestions |
| type | - | Use conventional |
| max-length | 100 | Max message length |
| locale | en | Message language |
| timeout | 10000 | API timeout (ms) |
| gh_enabled | true | Enable gh features |

Custom prompts

Create a .dash folder in your repository:

- .dash/commit.md - Overrides commit prompt
- .dash/pr.md - Overrides PR prompt

When these files exist, dash uses them instead of the built-in prompts.

Monorepo support: Dash searches up the directory tree, so you can have:

`
monorepo/
├── .dash/commit.md # Root rules
└── packages/
├── api/.dash/commit.md # API rules
└── web/.dash/commit.md # Web rules
`

Each package can have its own prompts.

Environment variables

| Variable | Description |
| -------------- | ----------- |
| GROQ_API_KEY | API key |
| HTTPS_PROXY | HTTP proxy |

GitHub CLI

Requires gh:

- dash pr
- dash issue

Works without gh:

- dash commit
- dash hook
- dash config
- dash setup

Troubleshooting

$3

Many Linux systems (Debian, Ubuntu, etc.) have /usr/bin/dash (the Debian Almquist Shell) installed. If your npm bin directory is lower in PATH priority, the system shell runs instead.

Solution: Use dash-cli instead of dash:

`bash
dash-cli setup
dash-cli commit
dash-cli pr
`

Both dash and dash-cli are provided as binary names. Use whichever works on your system.

Alternative: Fix your PATH to prioritize npm globals:

`bash


Check where dash resolves to

which dash

Check npm global bin location

npm bin -g

Add npm bin to PATH (in .bashrc/.zshrc)

export PATH="$(npm bin -g):$PATH"
`

Development

`bash
git clone https://github.com/koushikxd/dash-cli.git
cd dash/packages/cli

pnpm install
pnpm build
pnpm dev
pnpm test
`

Structure

`
packages/cli/
├── src/
│ ├── commands/ # Command implementations
│ ├── utils/ # Git, config, API helpers
│ ├── errors.ts
│ └── index.ts
├── tests/
└── dist/
`

Contributing

1. Fork it
2. Create a feature branch
3. Make changes
4. Run tests: pnpm test
5. Use dash to commit: dash commit
6. Use dash for PR: dash pr`

Acknowledgments

Inspired by noto by Sithija Nelusha Silva.

License

MIT