BAiSH — Your AI-Powered Terminal Assistant

BAiSH (AI in bash) is a terminal tool that turns plain English into shell commands using OpenRouter-powered LLMs like GPT-4, Mistral, Claude, and others.

No more Googling for syntax or stackoverflow diving. Just ask, and BAiSH will suggest the right command — with options to preview, explain, and save as aliases.

---

Features

• Converts natural language to terminal commands
• Supports --explain mode for breakdowns
• --dry run mode to preview before execution
• Alias system (baish alias deploy 'git push')
• Persistent config (API key + default model)
• One-time --key and --model overrides
• Built on Node.js + OpenRouter + your preferred LLM

---

Installation

npm install -g baish

Or run directly (future):

npx baish "show hidden files"

---

First Run Setup

BAiSH will prompt for your OpenRouter API key on first run and save it securely in ~/.baish/config.json.

---

Usage

baish "make all .sh files executable"

baish "remove all node_modules folders" --dry

baish "chmod file" --explain

---

Config

baish config model gpt-4
baish reset

---

Aliases

baish alias deploy "git push origin main"
baish deploy

---

Flags

Flag	Description
--model	Temporarily use a specific model
--key	Temporarily use a specific API key
--dry	Don't run the command, just preview it
--explain	Show a human-readable explanation

---

Help

baish help

---

License

MIT © 2025 Akhand Yaduvanshi

Disclaimer

This README.md is generated by GPT-4.1