EPAM CLI

AI-powered command-line workflow tool for developers

Installation • Quick Start • Features • Documentation • Contributing

🌟 Overview

EPAM CLI is a powerful command-line AI workflow tool adapted from Gemini CLI (details), enhanced with support for EPAM DIAL system models including GEMINI, CHATGPT, CLAUDE, and DEEPSEEK. It enhances your development workflow with advanced code understanding, automated tasks, and intelligent assistance.

💡 Free Options Available

Get started with EPAM CLI at no cost using any of these free options:

• EPAM CLI - Free for all users

✨ Key Features

• Code Understanding & Editing - Query and edit large codebases beyond traditional context window limits
• Workflow Automation - Automate operational tasks like handling pull requests and complex rebases
• Multi-Model Support - Compatible with EPAM DIAL system models: GEMINI, CHATGPT, CLAUDE, DEEPSEEK
• Enterprise Integration - Seamless integration with Azure OpenAI and EPAM's AI infrastructure

🚀 Installation

Prerequisites

Ensure you have Node.js version 20 or higher installed.

curl -qL https://www.npmjs.com/install.sh | sh

Install from npm

npm install -g @test2waterzhong/epam-cli@latest
epam-cli --version

Install from GitLab Release

Download the portable binary directly from the latest release:

# Download the portable binary
curl -L "https://git.epam.com/epm-cnrm/EPAM-CODE/-/releases/v0.0.8/downloads/epam-cli-portable.js" -o epam-cli.js
chmod +x epam-cli.js

# Run the portable binary
./epam-cli.js

Install from source

git clone https://git.epam.com/epm-cnrm/EPAM-CODE.git
cd EPAM-CODE
npm install
npm install -g .

🎯 Quick Start

# Start EPAM CLI
epam-cli

# Example commands
> Explain this codebase structure
> Help me refactor this function
> Generate unit tests for this module

🔧 Configuration

Session Management

Control your token usage with configurable session limits to optimize costs and performance.

Configure Session Token Limit

Create or edit .epam-cli/settings.json in your home directory:

{
  "sessionTokenLimit": 32000
}

Session Commands

• /compress - Compress conversation history to continue within token limits
• /clear - Clear all conversation history and start fresh
• /stats - Check current token usage and limits

📝 Note: Session token limit applies to a single conversation, not cumulative API calls.

Authentication

Choose your preferred authentication method based on your needs:

Azure OpenAI (EPAM Enterprise)

Use EPAM's Azure OpenAI proxy for enterprise access:

Configuration:

export AZURE_OPENAI_ENDPOINT="https://ai-proxy.lab.epam.com"
export AZURE_OPENAI_API_VERSION="2023-05-15"
export AZURE_OPENAI_DEPLOYMENT="your_deployment_name"
export AZURE_OPENAI_API_KEY="your_api_key"

Supported Models:

• GEMINI models through Azure OpenAI proxy
• CHATGPT models
• CLAUDE models
• DEEPSEEK models

OpenAI-Compatible API

Use API keys for OpenAI or other compatible providers:

Configuration Methods:

1. Environment Variables

   export OPENAI_API_KEY="your_api_key_here"
   export OPENAI_BASE_URL="your_api_endpoint"
   export OPENAI_MODEL="your_model_choice"

2. Project .env File

   Create a .env file in your project root:

   OPENAI_API_KEY=your_api_key_here
   OPENAI_BASE_URL=your_api_endpoint
   OPENAI_MODEL=your_model_choice

Regional Provider Options

⚠️ Regional Notice:

• Mainland China: Use Alibaba Cloud Bailian or ModelScope
• International: Use Alibaba Cloud ModelStudio or OpenRouter

Option 1: Alibaba Cloud Bailian (Apply for API Key)

export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"

⌨️ Commands & Shortcuts

Session Commands

• /help - Display available commands
• /clear - Clear conversation history
• /compress - Compress history to save tokens
• /stats - Show current session information
• /exit or /quit - Exit EPAM CLI

Keyboard Shortcuts

• Ctrl+C - Cancel current operation
• Ctrl+D - Exit (on empty line)
• Up/Down - Navigate command history

📊 Benchmark Results

📄 License

LICENSE

⭐ Star History

📦 Repository & Packages

• Source Code: https://git.epam.com/epm-cnrm/EPAM-CODE
• NPM Package: @test2waterzhong/epam-cli
• Latest Release: EPAM CLI v0.0.8
• Portable Binary: Download epam-cli.js
• Issues: EPAM GitLab Issues
• Documentation: EPAM CLI Documentation