CLI Assist

AI coding assistant in your terminal powered by OpenRouter.

Features

• Terminal-based AI assistant - Work directly in your terminal
• Code-aware tools - Read, write, edit, grep, glob, and execute shell commands
• Streaming responses - See AI responses in real-time
• Flexible models - Use any OpenRouter-supported model

Demo

Watch Demo Video

Prerequisites

• Node.js 18+
• npm
• An OpenRouter API key

Installation

From npmjs.com (recommended)

npm install -g @atharvapatill/cli-assist
cli-assist

From GitHub Packages

npm install -g @atharvapatil2005/cli-assist --registry=https://npm.pkg.github.com
cli-assist

From source

git clone https://github.com/Atharvapatil2005/cli-assist.git
cd cli-assist
npm install
npm run build
npm link
cli-assist --model openai/gpt-4o-mini

Setup

Environment Variables

Create a .env file in your project directory:

cp .env.example .env

Edit .env and add your OpenRouter API key:

OPENROUTER_API_KEY=your_key_here

Or export it directly:

export OPENROUTER_API_KEY=your_key_here

Usage

Basic Usage

cli-assist

Specify a Model

cli-assist --model openai/gpt-4o-mini
cli-assist --model anthropic/claude-3.5-sonnet
cli-assist --model google/gemini-2.0-flash

Exit

Type exit or quit, or press Ctrl+C.

Available Tools

| Tool | Description | |------|------------| | Read | Read files from the filesystem | | Write | Write content to files | | Edit | Edit existing files | | Grep | Search file contents | | Glob | Find files by pattern | | Bash | Execute shell commands |

Keyboard Shortcuts

| Shortcut | Action | |----------|--------| | ↑↓ | Navigate command history | | Ctrl+C | Quit |

License

MIT

Author

Atharva Patil