JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 9
  • Score
    100M100P100Q54068F
  • License ISC

AI-powered coding assistant for your terminal. Built with Groq's lightning-fast LLMs, featuring autonomous tool execution, syntax-highlighted output, and git integration.

Package Exports

  • prab-cli
  • prab-cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (prab-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Prab CLI

An AI-powered coding assistant for your terminal. Built with Groq's lightning-fast LLMs, featuring autonomous tool execution, syntax-highlighted output, and seamless git integration.

Version License

Features

  • AI-Powered Coding Assistant - Chat with AI that understands your codebase
  • Autonomous Tool Execution - AI can read, write, and edit files directly
  • Git Integration - Built-in git status, diff, commit, push, and more
  • Syntax Highlighting - Beautiful colored output for code blocks and diffs
  • Multiple Models - Switch between Groq models on the fly
  • Task Tracking - Built-in todo management for complex tasks
  • Safety Checks - Confirmation prompts for destructive operations
  • Session Logging - Debug and track all AI interactions

Installation

npm install -g prab-cli

Quick Start

  1. Get a Groq API Key from console.groq.com

  2. Configure your API key:

groq-cli config
  1. Start chatting:
groq-cli

Usage

Interactive Mode

Simply run groq-cli to start an interactive session:

groq-cli

You'll see the welcome banner and can start chatting with the AI:

   ____             __      ________    ____
   / __ \_________ _/ /_    / ____/ /   /  _/
  / /_/ / ___/ __ `/ __ \  / /   / /    / /
 / ____/ /  / /_/ / /_/ / / /___/ /____/ /
/_/   /_/   \__,_/_.___/  \____/_____/___/

  Active Model: llama-3.3-70b-versatile
  Available Tools: 14

> Help me refactor the authentication module

Slash Commands

Type / during a session to access the command menu:

Command Description
/ Open command menu
/exit Exit the CLI
/clear Clear chat history
/context Show loaded file context
/tools List available tools
/todos Show current todo list

Command Menu Options

  1. Select Model - Switch between available Groq models
  2. Usage - View current model and session stats
  3. Tools - List all available tools
  4. Todos - View task list
  5. Clear Todos - Reset task list
  6. Context - Show file context
  7. Clear History - Reset conversation
  8. API Key - Update your API key
  9. Exit - Quit the CLI

Available Tools

The AI has access to these tools for autonomous coding:

File Operations

Tool Description
read_file Read file contents with line numbers
write_file Create or overwrite files
edit_file Make targeted edits to existing files
glob Find files matching patterns
grep Search file contents with regex

Git Operations

Tool Description
git_status Show working tree status
git_diff Show changes between commits
git_log View commit history
git_add Stage files for commit
git_commit Create a commit
git_branch List or create branches
git_push Push commits to remote

System

Tool Description
bash Execute shell commands
manage_todos Track tasks and progress

Colorized Output

The CLI provides rich, colorized output for better readability:

Git Diff

  • Added lines in green
  • Removed lines in red
  • Hunk headers in cyan
  • File headers in bold

Code Blocks

  • Keywords highlighted in magenta
  • Strings in green
  • Numbers in yellow
  • Comments in gray
  • Function calls in cyan

Markdown

  • Headers in cyan bold
  • Inline code with gray background
  • Bullet points with yellow markers
  • Bold and italic text styling

Configuration

API Key

Set your Groq API key:

# Interactive prompt
groq-cli config

# Or directly
groq-cli config YOUR_API_KEY

Reset API Key

groq-cli reset

Model Management

groq-cli model

Options:

  • List available models
  • Show current model
  • Switch to a different model

Supported Models

The CLI supports all Groq models including:

  • llama-3.3-70b-versatile (default)
  • llama-3.1-70b-versatile
  • llama-3.1-8b-instant
  • mixtral-8x7b-32768
  • gemma2-9b-it
  • And more...

Models are fetched dynamically from the Groq API.

Session Logging

Debug logs are stored in ~/.prab-cli/logs/. View them with:

# View latest log
npm run log

# List all logs
npm run log:list

Examples

Read and Edit a File

> Read the package.json and update the version to 2.0.0

The AI will:

  1. Use read_file to view package.json
  2. Use edit_file to update the version
  3. Show you the diff of changes

Git Workflow

> Check the git status and commit all changes with a descriptive message

The AI will:

  1. Run git_status to see changes
  2. Use git_add to stage files
  3. Create a commit with git_commit
> Find all files that import the 'express' module

The AI will use grep to search for import statements.

Safety Features

  • Confirmation Prompts - Destructive operations require approval
  • Session Memory - Remember choices for similar operations
  • Read-Only by Default - Tools like read_file and git_status run without confirmation

Requirements

  • Node.js 18+
  • npm or yarn
  • Groq API key

Development

# Clone the repo
git clone https://github.com/prab002/prab-cli.git
cd prab-cli

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Run production build
npm start

License

ISC

Author

Prabhanjan Sharma

Built with Groq | LangChain | Chalk