Mistral Vibe CLI Agent

2.7.5 · active · verified Thu Apr 16

Mistral Vibe is a minimal command-line interface (CLI) coding agent developed by Mistral AI, currently at version 2.7.5. It provides a conversational interface to interact with a codebase, allowing developers to use natural language for tasks like exploring, modifying, and interacting with projects through a powerful set of integrated tools. The library maintains an active development pace with frequent updates, often multiple releases within a month, focusing on new features, performance improvements, and bug fixes.

Common errors

```
Error: API error from mistral (model: mistral-vibe-cli-latest): LLM backend error...
```
cause The Mistral API key is either not provided, invalid, or there's a transient issue with the Mistral backend.

fix Ensure `MISTRAL_API_KEY` is correctly set as an environment variable (e.g., `export MISTRAL_API_KEY="YOUR_KEY"`) or configured via `vibe --setup`. Verify your API key's validity on the Mistral AI console.
```
Error: API error from mistral (model: mistral-vibe-cli-latest): Ratelimit exceeded.
```
cause Too many rapid requests were sent to the Mistral API within a short period, hitting rate limits.

fix Reduce the frequency of your requests, wait a short period before retrying, or check if `--auto-approve` is causing too many rapid tool calls.
```
Requires-Python-Error: mistral-vibe requires Python >=3.12...
```
cause The Python environment being used is older than version 3.12.

fix Upgrade your Python installation to version 3.12 or newer, or switch to a virtual environment configured with Python 3.12+.
```
Command 'vibe' not found
```
cause The `mistral-vibe` package's executable is not in your system's PATH, or the installation failed.

fix Ensure `pip install mistral-vibe` completed successfully. If using a virtual environment, ensure it's activated. On Linux/macOS, consider the `curl` installer or `uv tool install mistral-vibe` to ensure the executable is correctly placed and linked.

Warnings

breaking With Mistral Vibe 2.0 (released January 2026), the underlying Devstral 2 model shifted from free testing to a paid offering, bundled with Mistral's Le Chat plans. Direct API key usage might incur charges, and access might require specific plans.
Fix: Review Mistral AI's pricing and plans, and ensure your API key is associated with an active, paid plan if using cloud models.
gotcha A Mistral API key is mandatory for most operations and must be configured via `vibe --setup`, the `MISTRAL_API_KEY` environment variable, or a `.env` file in `~/.vibe/`. Without it, Vibe will prompt for the key or fail.
Fix: Set your API key using `export MISTRAL_API_KEY="your_mistral_api_key"` in your shell, create a `.env` file in `~/.vibe/`, or run `vibe --setup`.
gotcha While Mistral Vibe works on Windows, it officially supports and targets UNIX environments (Linux and macOS). Users on Windows might encounter specific issues or limitations.
Fix: For Windows users, consider using Windows Subsystem for Linux (WSL) for a more officially supported experience, or be prepared for potential platform-specific issues.
gotcha Users may encounter 'Ratelimit exceeded' errors or 'LLM backend error' during rapid sequential requests to the Mistral API, leading to halted execution. The CLI might not automatically retry or regulate requests effectively in all scenarios.
Fix: Reduce the frequency of your requests, wait a short period before retrying, or check if features like `--auto-approve` are causing too many rapid tool calls without sufficient delays.
gotcha Mistral Vibe explicitly requires Python 3.12 or newer. Using older Python versions will lead to installation or runtime errors.
Fix: Upgrade your Python installation to version 3.12 or newer, or switch to a virtual environment configured with Python 3.12+.

Install

pip install mistral-vibe Using pip
uv tool install mistral-vibe Using uv (requires uv installed)
curl -LsSf https://mistral.ai/vibe/install.sh | bash Recommended for Linux/macOS

Quickstart

To quickly start using Mistral Vibe, navigate to your project's root directory and run the `vibe` command. Ensure your Mistral API key is set as an environment variable or configured via `vibe --setup`. The first run will set up configuration and prompt for the API key if missing.

export MISTRAL_API_KEY="$MISTRAL_API_KEY"
cd /path/to/your/project
vibe
# Interact with the agent, e.g., type: > Can you find all instances of 'TODO'?

view raw JSON →