Rawi (راوي) is the developer-friendly AI CLI that brings the power of 11 major AI providers directly to your terminal. With seamless shell integration, persistent conversations, and 200+ specialized prompt templates, Rawi transforms your command line into
The AI-Powered CLI That Transforms Your Terminal Into an Intelligent Workspace
Rawi (راوي) is the developer-friendly AI CLI that brings the power of 11 major AI providers directly to your terminal. With seamless shell integration, persistent conversations, and 200+ specialized prompt templates, Rawi transforms your command line into an intelligent development workspace.
"راوي" means "storyteller" in Arabic — every great story starts with a question.
Rawi isn't just another AI CLI tool — it's your complete AI-powered development environment:
🔥 11 AI Providers — OpenAI, Anthropic, Google, DeepSeek, Ollama, LM Studio, Azure, Bedrock, Mistral, Cerebras, and xAI
🛡️ Privacy First — Local AI support with Ollama and LM Studio — no data leaves your machine
⚡ Developer Optimized — Built specifically for coding workflows and technical tasks
🔄 Shell Integration — Perfect pipes, redirects, script automation, and smart completion
📊 Smart Sessions — Persistent conversations with context awareness
🎯 200+ Templates — Expert-level prompt templates for specialized responses
🌍 Multilingual — Full support for English and Arabic (راوي)
📚 Rich History — Search, export, and manage your AI conversations
🔧 Profile Management — Multiple configurations for different projects
Get your AI-powered terminal companion running in under 30 seconds:
# Install globally via npm
npm install -g rawi
# One-command setup (interactive)
rawi configure
# Start asking questions immediately
rawi ask "What's the difference between TypeScript and JavaScript?"
# 💡 Quick coding help
rawi ask "Create a React component for file upload with drag-and-drop"
# 🐛 Debug errors instantly
rawi ask "Fix this Python error: NameError: name 'x' is not defined"
# 🎭 Get specialized AI personas
rawi ask --act security-expert "Analyze this authentication code for vulnerabilities"
# 💬 Smart session management
rawi ask "How do I handle state management?" --new-session
rawi ask "What about Redux specifically?" --session abc123
rawi chat --session-name "React Learning" --list-sessions
# 🔧 Integrate with your workflow
git diff | rawi ask "Review these changes for potential issues"
cat server.js | rawi ask --act code-reviewer "Optimize this Express.js code"
# 📊 Session organization and insights
rawi history ask --limit 10 # View ask sessions
rawi history chat --search "debugging" # Search chat sessions
rawi history exec --search "system" # Search exec sessions
rawi history ask --all-profiles --provider openai # Filter ask sessions by provider
Access the best AI models through one unified interface:
| Provider | Top Models | API Key | Local | Best For |
|---|---|---|---|---|
| 🔵 OpenAI | GPT-4o, GPT-4, O1, O3, GPT-4o-mini | ✅ | ❌ | General development, coding |
| 🟣 Anthropic | Claude 3.5 Sonnet, Claude 3.5 Haiku | ✅ | ❌ | Analysis, safety, long content |
| Gemini 2.0 Flash, Gemini 1.5 Pro | ✅ | ❌ | Fast inference, multimodal | |
| � DeepSeek | DeepSeek-Chat, DeepSeek-Reasoner | ✅ | ❌ | Cost-effective, reasoning |
| �🟢 Ollama | Llama 3.2, CodeLlama, Qwen, +100 more | ❌ | ✅ | Privacy, offline, free |
| 🔧 LM Studio | Llama 3.3, Phi-4, Gemma-3, Qwen-3 | ❌ | ✅ | Local models, GUI management |
| 🟠 Mistral | Mistral Large, Mistral Small, Pixtral | ✅ | ❌ | European AI, multilingual |
| ⚡ Cerebras | Llama 3.3 70B, Llama 3.1 70B/8B | ✅ | ❌ | Ultra-fast inference, speed |
| 🔷 Azure | Enterprise OpenAI deployments | ✅ | ❌ | Enterprise, compliance |
| 🟠 Bedrock | Claude, Llama, Titan via AWS | ✅ | ❌ | AWS integration, scale |
| 🤖 xAI | Grok-3, Grok-2, Grok-Beta | ✅ | ❌ | Real-time, conversational |
🛡️ Privacy Focused: Use Ollama or LM Studio for complete privacy — all processing happens locally on your machine.
Transform your prompts with expertly crafted AI personas for specialized responses. Templates work globally across all profiles:
# 🔍 Browse all available templates
rawi act --list
# 📖 Get detailed template information
rawi act --show ethereum-developer
# ➕ Create your own custom templates
rawi act --create
# ✏️ Edit existing custom templates
rawi act --edit my-template
# 🗑️ Remove custom templates
rawi act --delete my-template
# 🚀 Use templates in conversations (works with any profile)
rawi ask --act linux-terminal "list files in home directory with details"
rawi ask --act code-reviewer "analyze this Python function for improvements"
rawi ask --act security-expert "audit this authentication implementation"
🛠️ Development
ethereum-developer — Smart contract development & securitylinux-terminal — Terminal command simulationcode-reviewer — Code analysis and optimization🔒 Security
security-expert — Security analysis and auditingpenetration-tester — Security testing and vulnerability assessment📝 Documentation
tech-writer — Technical documentationapi-documenter — API documentation and examples🗄️ Database
database-admin — SQL optimization and database managementdata-analyst — Data analysis and insights🎨 Creative
ux-designer — User experience and interface designmarketing-expert — Marketing copy and strategyUse rawi act --list to explore all 200+ available templates across 15+ categories!
Master Rawi's powerful command set:
rawi ask — Your AI AssistantThe heart of Rawi - ask questions and get intelligent responses.
# Basic questions
rawi ask "How do I optimize this SQL query?"
# Use specific profiles for different projects
rawi ask "Review this code" --profile work
# 🆕 Enhanced Session Management
rawi ask "What about performance optimization?" --session abc123
rawi ask "Start new discussion" --new-session
rawi ask "Continue from list" --list-sessions
rawi ask "Named session" --session-name "API Design Discussion"
# Apply specialized AI personas
rawi ask --act security-expert "Analyze this authentication logic"
# Pipe input for analysis
cat server.js | rawi ask "Review this Express server for security issues"
git diff | rawi ask "Write a conventional commit message for these changes"
# Session management options
rawi ask "Show session details" --show-session-id
rawi ask "Export this conversation" --export-session abc123
rawi ask "Rename session" --rename-session "New Session Name"
rawi chat — Interactive ConversationsStart interactive chat sessions for back-and-forth conversations with AI.
# Start an interactive chat session
rawi chat
# Use specific profile for the chat session
rawi chat --profile work
# Apply a specialized persona for the entire chat
rawi chat --act ethereum-developer
# Start chat with verbose information
rawi chat --verbose
# 🆕 Session Management Options
rawi chat --new-session # Force create new session
rawi chat --session abc123 # Continue specific session
rawi chat --session-name "Project X" # Start with custom session name
rawi chat --list-sessions # List and select from existing sessions
rawi chat --export-session abc123 # Export session to JSON file
# Advanced session options
rawi chat --show-session-id # Display current session ID
rawi chat --session-stats # Show session statistics
rawi chat --rename-session "New Name" # Rename current session
# Chat commands within a session
# /help - Show chat commands
# /quit - Exit the chat (also /exit)
# /clear - Clear conversation history
# /session - Show current session info
# /sessions - List all sessions
# /export - Export current session
# /rename - Rename current session
# /new - Start new session
Perfect for:
rawi exec — Command GenerationConvert natural language descriptions into executable CLI commands with safety validation.
# Basic command generation
rawi exec "list all files in current directory"
rawi exec "show disk usage for home directory"
rawi exec "find all Python files larger than 1MB"
# Use with piped input
echo "compress all log files" | rawi exec
printf "backup database\n" | rawi exec --dry-run
# Interactive mode (prompts for description)
rawi exec
# Safety and validation options
rawi exec "restart nginx service" --dry-run # Preview without executing
rawi exec "delete old files" --confirm # Force confirmation prompt
rawi exec "long backup process" --timeout 300 # Set custom timeout
rawi exec "show network config" --copy-command # Copy command to clipboard
# Use specific profile
rawi exec "server deployment commands" --profile production
# Verbose output with debugging
rawi exec "complex git operations" --verbose
Perfect for:
Safety Features:
rawi configure — Setup & ManagementEasy setup and profile management for all your AI providers.
# Interactive setup (recommended for beginners)
rawi configure
# Quick provider setup
rawi configure --provider openai --model gpt-4o --api-key sk-xxx
# Advanced configuration with all options
rawi configure --provider anthropic \
--model claude-3-5-sonnet-20241022 \
--api-key sk-ant-xxx \
--temperature 0.7 \
--max-tokens 4096
# Profile management
rawi configure --list # List all profiles
rawi configure --show # Show current config
rawi configure --show --profile work # Show specific profile
rawi configure --delete old-profile # Delete profile
rawi history — Conversation ManagementPowerful tools to manage your AI conversation history with separate views for ask and chat sessions.
# Basic history commands
rawi history ask # Show ask session history
rawi history chat # Show chat session history
rawi history exec # Show exec session history
# Session listings with filtering
rawi history ask --limit 10 # Show last 10 ask sessions
rawi history chat --all-profiles # Show chat sessions from all profiles
rawi history exec --limit 5 # Show last 5 exec sessions
rawi history ask --search "docker" # Search ask sessions for "docker"
rawi history chat --provider openai # Show chat sessions using OpenAI
rawi history exec --search "git" # Search exec sessions for "git"
# Advanced filtering options
rawi history ask --from 2024-01-01 # Ask sessions from specific date
rawi history chat --model gpt-4 # Chat sessions using specific model
rawi history exec --profile work # Exec sessions from work profile
rawi history ask --profile work # Ask sessions from work profile
rawi history chat --to 2024-12-31 # Chat sessions up to specific date
# Search across message content
rawi history ask --search "debugging react"
rawi history chat --search "typescript errors"
rawi history exec --search "system commands"
# Provider and model filtering
rawi history ask --provider ollama --model llama3.2
rawi history chat --provider anthropic --model claude-3-5-sonnet
rawi history exec --provider openai --model gpt-4
rawi act — Template ExplorerDiscover and use specialized AI personas.
# Browse all available templates
rawi act --list
# Show detailed template information
rawi act --show ethereum-developer
# Search templates (use with grep)
rawi act --list | grep -i security
rawi provider — Provider InformationExplore AI providers and their capabilities.
# List all supported providers
rawi provider --list
# Show available models for specific provider
rawi provider --list-models openai
rawi provider --list-models anthropic
rawi info — System InformationGet information about Rawi and your configuration.
# Show system information
rawi info
# Show profile details
rawi info --profiles
Rawi's advanced session management system lets you maintain context across conversations, organize your AI interactions, and never lose track of important discussions.
Sessions are persistent conversation threads that:
# Start a focused work session
rawi chat --session-name "API Design Review" --profile work
# Continue yesterday's conversation
rawi ask "What about the security concerns we discussed?" --session abc123
# List and select from your sessions interactively
rawi ask "Continue where we left off" --list-sessions
# Export important conversations
rawi history export abc123 --output "project-discussion.json"
📋 Project Planning Session
# Start dedicated project session
rawi chat --session-name "E-commerce Platform Design" --act solution-architect
# Within chat: plan architecture, discuss features, review decisions
# Exit and continue later
rawi ask "Let's finalize the database schema" --session ecommerce-123
🐛 Debugging Session
# Start debugging session with context
rawi ask "I'm getting authentication errors" --new-session --act debugging-expert
# Continue with code snippets and logs
cat error.log | rawi ask "Analyze these authentication errors" --session debug-456
# Come back with solutions
rawi ask "The JWT validation fix worked, now what about rate limiting?" --session debug-456
📚 Learning Session
# Long-term learning conversation
rawi chat --session-name "Machine Learning Journey" --act ai-instructor
# Build knowledge over multiple days
rawi ask "Yesterday we covered neural networks, today let's discuss transformers" --session ml-789
Create and Name Sessions
rawi chat --session-name "Sprint Planning Q1" # Named interactive session
rawi ask "Quick question" --new-session # Force new session
Navigate and Select Sessions
rawi history sessions # List all sessions
rawi history sessions --interactive # Pick from interactive list
rawi chat --list-sessions # Select session for chat
Session Information
rawi history show abc123 # View full conversation
rawi history sessions --stats # Usage statistics
rawi chat --show-session-id # Display current session ID
Organize and Clean Up
rawi history rename abc123 "Updated Name" # Rename sessions
rawi history delete abc123 # Remove unwanted sessions
rawi history cleanup --days 30 # Bulk cleanup old sessions
Export and Backup
rawi history export abc123 # Export single session
rawi history export --output "backup.json" # Export all history
Track your AI usage patterns:
# Overall statistics
rawi history stats
# Shows: Total sessions, messages, provider usage, time patterns
# Session-specific metrics
rawi history sessions --table
# Shows: Session IDs, names, message counts, creation dates
# Usage insights
rawi history sessions --profile work --stats
# Shows: Work-specific session analytics
Interactive Selection with Full IDs
Smart Session Continuation
Export Capabilities
Get up and running with any AI provider in minutes:
# OpenAI (most popular - great for general development)
rawi configure --provider openai --model gpt-4o --api-key sk-your-key
# Anthropic Claude (excellent for analysis and safety)
rawi configure --provider anthropic --model claude-3-5-sonnet-20241022 --api-key sk-ant-xxx
# Google Gemini (fast and efficient)
rawi configure --provider google --model gemini-2.0-flash-exp --api-key AIza-xxx
# DeepSeek (cost-effective with reasoning capabilities)
rawi configure --provider deepseek --model deepseek-chat --api-key sk-your-deepseek-key
# Ollama (completely free and private)
rawi configure --provider ollama --model llama3.2
# Azure OpenAI for enterprise deployments
rawi configure --provider azure \
--model your-deployment-name \
--resource-name your-resource \
--api-key your-azure-key
# AWS Bedrock with credential chain
rawi configure --provider bedrock \
--model anthropic.claude-3-sonnet-20240229-v1:0 \
--use-provider-chain \
--region us-west-2
# Multiple profiles for different projects
rawi configure --profile work --provider openai --model gpt-4o
rawi configure --profile personal --provider ollama --model llama3.2
rawi configure --profile enterprise --provider azure --model gpt-4o
# Customize AI behavior
rawi configure --provider openai \
--model gpt-4o \
--temperature 0.7 \
--max-tokens 4096 \
--language english
# Multi-language support
rawi configure --language arabic # Full Arabic support
See how Rawi integrates seamlessly into your development workflow:
# Review git changes before committing
git diff | rawi ask "Review these changes for potential issues"
# Security analysis of entire files
cat src/auth.js | rawi ask --act security-expert "Analyze for vulnerabilities"
# Get improvement suggestions
rawi ask --act code-reviewer "How can I optimize this function?" < utils.py
# Generate conventional commit messages
git diff --cached | rawi ask "Write a conventional commit message"
# Create release notes
git log --oneline $(git describe --tags --abbrev=0)..HEAD | \
rawi ask "Create release notes from these commits"
# Summarize branch changes
git log --oneline main..feature-branch | \
rawi ask "Summarize the changes in this feature branch"
# Debug specific error messages
rawi ask "Fix this Python error: NameError: name 'x' is not defined"
# Analyze application logs
tail -100 /var/log/app.log | rawi ask "Summarize errors and suggest fixes"
# Understand complex algorithms
rawi ask --act code-reviewer "Explain this algorithm step by step" < algorithm.py
# Database performance optimization
rawi ask --act database-admin "Optimize this slow query" < queries.sql
# Generate API documentation
rawi ask --act tech-writer "Document this API endpoint" < api.js
# Create comprehensive README files
rawi ask "Create a comprehensive README for this project" < package.json
# Write comprehensive test cases
rawi ask --act qa-engineer "Generate unit tests for this function" < utils.js
# Generate Docker configurations
rawi ask "Generate Docker configuration for this Node.js app"
# Generate CI/CD workflows
rawi ask "Create a GitHub Actions workflow for CI/CD" > .github/workflows/deploy.yml
# Create command automation
rawi exec "create a backup script for all project files"
rawi exec "setup development environment for new team member"
# Create backup scripts
rawi ask "Create a database backup script for PostgreSQL" > backup.sh
# Execute system tasks
rawi exec "find and clean up old log files safely"
echo "optimize system performance" | rawi exec --dry-run
# Generate server configurations
rawi ask "Generate nginx config for this Express app" > nginx.conf
# Transform data formats
cat data.json | rawi ask "Transform this JSON into CSV format" > data.csv
# Analyze CSV datasets
cat sales-data.csv | rawi ask "Analyze this sales data and identify trends"
# Process API responses
curl -s api.example.com/data | rawi ask "Explain this API response structure"
# Log analysis and monitoring
grep ERROR app.log | rawi ask "Categorize these errors and suggest fixes"
# Configuration review
cat docker-compose.yml | rawi ask "Review this Docker configuration for best practices"
Process and analyze various document formats with intelligent content extraction:
# PDF document analysis
rawi ask --file report.pdf "Summarize the key findings in this report"
# Code review from files
rawi ask --file src/app.js "Review this code for potential improvements"
# Excel data analysis
rawi ask --file sales-data.xlsx "What trends do you see in this data?"
# Microsoft Word document processing
rawi ask --file requirements.docx "Extract the main requirements from this document"
# Multiple file processing
rawi ask --files config.json package.json "Compare these configuration files"
# Batch processing with glob patterns
rawi ask --batch "src/**/*.{js,ts}" "Review all TypeScript/JavaScript files for consistency"
# Process files with specific templates
rawi ask --file database-schema.sql --act database-admin "Analyze this schema for optimization"
# Combine file content with prompts
rawi ask --file error-logs.txt "Analyze these logs and suggest solutions"
Supported File Formats:
Advanced File Features:
# Process specific Excel sheets
rawi ask --file data.xlsx --sheet "Q4 Sales" "Analyze Q4 performance"
# Override file type detection
rawi ask --file data.unknown --file-type txt "Process this as plain text"
# Parallel processing for speed
rawi ask --batch "docs/**/*.md" --parallel "Create a documentation index"
# Continue processing on errors
rawi ask --batch "**/*.json" --continue-on-error "Validate all JSON files"
# Verbose output for debugging
rawi ask --file large-dataset.csv --verbose "Summarize this data"
# Install globally via npm
npm install -g rawi
# Or using yarn
yarn global add rawi
# Or using pnpm
pnpm add -g rawi
# Or using bun
bun add -g rawi
# Using npx (no installation required)
npx rawi ask "What is TypeScript?"
# Using homebrew (macOS/Linux)
brew install rawi # Coming soon
# Using scoop (Windows)
scoop install rawi # Coming soon
rawi --version
rawi info
Enable shell completion for faster and more efficient CLI usage:
# Auto-detect shell and install completion
rawi completion --install
# Or specify your shell explicitly
rawi completion bash --install # For bash
rawi completion zsh --install # For zsh
rawi completion fish --install # For fish
# Just generate without installing
rawi completion bash # Creates ~/.rawi/completion/rawi-completion.bash
After installation, restart your terminal or source your shell profile:
# For bash
source ~/.bashrc
# For zsh
source ~/.zshrc
# For fish
source ~/.config/fish/config.fish
All platforms (Windows, macOS, Linux) support full rawi exec functionality with command generation, execution, and safety prompts.
npm install -g rawi
Pick one of these popular options:
🔵 OpenAI (Recommended for beginners)
# Get API key from: https://platform.openai.com/api-keys
rawi configure --provider openai --model gpt-4o --api-key sk-your-key
🟢 Ollama (Free & Private)
# Install Ollama first: https://ollama.com/download
ollama pull llama3.2
rawi configure --provider ollama --model llama3.2
🟣 Anthropic Claude (Great for analysis)
# Get API key from: https://console.anthropic.com/
rawi configure --provider anthropic --model claude-3-5-sonnet-20241022 --api-key sk-ant-xxx
# Ask your first question
rawi ask "Explain the difference between REST and GraphQL"
# Try with code analysis
echo "console.log('Hello World')" | rawi ask "Optimize this JavaScript code"
# Use a specialized template
rawi ask --act security-expert "What are common web security vulnerabilities?"
# Browse available templates
rawi act --list
# Check your conversation history
rawi history
# See all available providers
rawi provider --list
We welcome contributions! Here's how you can help:
rawi --version) and environment detailsgit checkout -b feature/amazing-feature)git commit -m 'Add some amazing feature')git push origin feature/amazing-feature)Read our full Contributing Guide for detailed information.
Rawi is licensed under the MIT License.
Mohammad Abu Mattar
If Rawi helps you be more productive, consider:
Made with ❤️ for developers worldwide
🌐 Website • 📚 Docs • 💬 Discussions • 🐛 Issues
FAQs
Rawi (راوي) is the developer-friendly AI CLI that brings the power of 11 major AI providers directly to your terminal. With seamless shell integration, persistent conversations, and 200+ specialized prompt templates, Rawi transforms your command line into
We found that rawi demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Socket researchers identified a malicious Chrome extension that manipulates Raydium swaps to inject an undisclosed SOL transfer, quietly routing fees to an attacker wallet.
Research
/Security News
Another wave of Shai-Hulud campaign has hit npm with more than 500 packages and 700+ versions affected.
Product
Add real-time Socket webhook events to your workflows to automatically receive software supply chain alert changes in real time.