mistralai/mistral-vibe

What is it?

Key features

• 01Conversational agent that reads, writes and patches files in your project.
• 02Shell command execution with managed sessions, plus grep search with ripgrep support.
• 03Subagent delegation and interactive questions to the user during a task.
• 04Approval modes from confirming every tool call to auto-approving all.
• 05Programmatic mode with turn, cost and token limits for scripting.
• 06Configurable through config.toml, with custom agents, skills and MCP servers.

Use cases

• Exploring an unfamiliar codebase by asking where things are and how they connect.
• Making multi-file refactors from a natural-language description.
• Running a bounded, unattended coding task from a shell script or CI job.
• Using Mistral models as the backend for a terminal-based coding workflow.

Quick start

1. 1

   Install with the one-line script for Linux and macOS (runs a remote shell script, so run it yourself from the README)

2. 2

   Install with uv

   uv tool install mistral-vibe
3. 3

   Or install with pip

   pip install mistral-vibe
4. 4

   Navigate to your project root and run Vibe

   vibe

Things to know

• !Officially supported and targeted at UNIX environments; Windows works but is not the main target.
• !Requires a Mistral API key to use the underlying models.
• !Requires Python 3.14 or newer.

Topics

FAQ

What is mistral-vibe?

Mistral's open-source command-line coding assistant that lets you explore and edit a codebase in natural language from the terminal. Mistral Vibe is a terminal-based coding agent powered by Mistral's models. You start it inside a project directory and interact through a chat prompt, asking it to find code, edit files, run shell commands, or work through multi-step tasks. Vibe passes the project's location, Git branch and recent commits to the agent as context.

Is mistral-vibe free to use? What license does it have?

mistral-vibe is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.

Is mistral-vibe still maintained?

Actively maintained. The last commit to mistral-vibe was on Oct 19, 2026.

What can I use mistral-vibe for?

Exploring an unfamiliar codebase by asking where things are and how they connect. Making multi-file refactors from a natural-language description. Running a bounded, unattended coding task from a shell script or CI job. Using Mistral models as the backend for a terminal-based coding workflow.

How do I install mistral-vibe?

Install with the one-line script for Linux and macOS (runs a remote shell script, so run it yourself from the README) Install with uv: uv tool install mistral-vibe Or install with pip: pip install mistral-vibe Navigate to your project root and run Vibe: vibe

Where can I get mistral-vibe?

The source code and installation instructions are on GitHub: https://github.com/mistralai/mistral-vibe