AICLI Documentation

AICLI is a powerful command-line interface for interacting with Azure AI Foundry models. It supports Claude, GPT, DeepSeek, and other OpenAI-compatible models.

Installation

Download Binary

Download the latest release from GitHub:

# Windows
curl -LO https://github.com/leonardo-matheus/azure-ai-cli/releases/latest/download/aicli-windows.zip

# Linux
curl -LO https://github.com/leonardo-matheus/azure-ai-cli/releases/latest/download/aicli-linux.tar.gz

# macOS
curl -LO https://github.com/leonardo-matheus/azure-ai-cli/releases/latest/download/aicli-macos.tar.gz

Install Globally

Run AICLI and use the built-in installer:

./aicli
❯ /install

This will copy the binary to your user directory and add it to PATH. Restart your terminal afterwards.

Build from Source

git clone https://github.com/leonardo-matheus/azure-ai-cli.git
cd azure-ai-cli
cargo build --release
./target/release/aicli

Quick Start

On first run, AICLI will guide you through configuration:

$ aicli

  No models configured. Let's add your first model!

  Model name: Claude Opus
  API Endpoint: https://your-resource.openai.azure.com
  API Key: ********
  Deployment name: claude-opus
  Model type (claude/gpt/deepseek/other): claude

  ✓ Model added successfully!

Configuration File

Configuration is stored in ~/.aicli/config.toml:

active_model = "claude-opus"
language = "en"

[models.claude-opus]
name = "Claude Opus 4.5"
api_key = "your-api-key-here"
endpoint = "https://your-resource.services.ai.azure.com"
deployment = "claude-opus-4-5"
model_type = "claude"
max_tokens = 8192
temperature = 0.7

[models.gpt-4]
name = "GPT-4 Turbo"
api_key = "your-api-key"
endpoint = "https://your-resource.openai.azure.com"
deployment = "gpt-4-turbo"
model_type = "gpt"
max_tokens = 4096
temperature = 0.7

Security Note

Never commit your config.toml with real API keys to version control.

Adding Models

You can add models interactively or by editing the config file:

❯ /model

  Models
  ↑↓ navigate · Enter select · Esc cancel

  ● Claude Opus 4.5 (Claude)
  ○ GPT-4 Turbo (GPT)
  + Add model

Azure AI Setup

To use AICLI with Azure AI Foundry:

Create an Azure AI resource in the Azure Portal
Deploy your desired model (Claude, GPT, etc.)
Copy the endpoint URL and API key
Add the model in AICLI with /model or edit config.toml

Commands

Command	Description
`/help`	Show available commands
`/model`	Interactive model selection
`/model <name>`	Switch to specific model
`/clear`	Clear conversation history
`/config`	Show current configuration
`/lang en\|pt`	Change language
`/history`	Show conversation history
`/install`	Install AICLI globally
`/uninstall`	Uninstall AICLI
`/exit`	Exit AICLI

File Context

Include files in your prompts using @ syntax:

❯ Explain this code @src/main.rs

❯ Refactor @utils/helpers.ts to use async/await

❯ Review @package.json and suggest improvements

Press Tab after @ for file autocompletion.

Tool Execution

AICLI can execute tools on your behalf:

execute_command - Run shell commands
read_file - Read file contents
write_file - Create or overwrite files
edit_file - Modify existing files
list_directory - List directory contents
search_files - Find files by pattern
search_content - Search text in files

Tip

The AI will automatically use these tools when needed. Just describe what you want to accomplish.

Model Types

Type	API Format	Models
`claude`	Anthropic Messages API	Claude 3 Opus, Sonnet, Haiku
`gpt`	OpenAI Chat Completions	GPT-4, GPT-4 Turbo, GPT-3.5
`deepseek`	OpenAI Chat Completions	DeepSeek Coder, Chat
`other`	OpenAI Chat Completions	Any compatible model

Keyboard Shortcuts

Key	Action
`Tab`	Autocomplete commands and files
`↑/↓`	Navigate history / model selection
`Enter`	Send message / Select option
`Ctrl+C`	Cancel current operation
`Ctrl+D`	Exit AICLI
`Esc`	Cancel selection menu

Troubleshooting

API Connection Errors

Verify your endpoint URL and API key in /config. Ensure your Azure resource is deployed and accessible.

Model Not Found

Check that the deployment name matches exactly what's configured in Azure AI Studio.

Prompt Color Issues

If colors don't display correctly, ensure your terminal supports ANSI escape codes. Windows Terminal and most modern terminals work well.

Installation Issues

If /install fails, you can manually copy the binary to a directory in your PATH:

# Windows
copy aicli.exe %USERPROFILE%\.aicli\bin\

# Linux/Mac
cp aicli ~/.local/bin/