Skip to main content

Get started with Mistral Vibe

Use Mistral Vibe as an AI assistant directly in your terminal.

Updated this week

What is Mistral Vibe?

Mistral Vibe is a lightweight, flexible, and fully configurable command-line AI assistant that runs on Windows, macOS, and Linux (as long as Python is available).

Powered by Mistral’s latest coding model (Devstral 2 🔎), it understands your project context and can generate code, propose edits, and run commands on your machine, both interactively and programmatically.

🔑 Perfect for:

  • developers working terminal-first

  • anyone who wants an AI assistant that interacts with their local environment

  • teams needing reproducible, script-friendly workflows in the command line

🙋 Quick question: Looking for Mistral Vibe’s README?


See the full documentation in the project README 🔎.

How to install Mistral Vibe

One-liner install (macOS/Linux)

Run this command to install Vibe in seconds:

curl -LsSf https://mistral.ai/vibe/install.sh | bash

Manual installation (macOS/Linux/Windows)

  1. Install Python 3.12+.

  2. Choose a package manager: uv or pip.

  3. Install Vibe:

    • uv: uv tool install mistral-vibe

    • pip: pip install mistral-vibe

How to use Mistral Vibe

Start Vibe in your project

Run it from your project’s root directory:

vibe

image

Vibe running in a terminal

Configure Mistral Vibe

Pick a theme

Choose the style you want for the interactive interface.

📌 You can always change the theme later with the /theme command.

image

Select your preferred theme

Add your API key

On first launch, Vibe prompts you for your Mistral Vibe API key. Generate one from the provided link and paste it into the terminal.

🔑 A Mistral account is required to create an API key.

image

Entering the API key on first launch

Start chatting with Vibe

Type your request directly into the prompt: ask a question, request code, or tell Vibe what to automate.

Vibe answers in context and can generate code, edit files, or run commands when needed.

🙋 Quick question: Can I run shell commands in Vibe?


Mistral Vibe can run shell commands on your behalf. But if you want to run commands directly in your terminal, simply prefix them with !. For example, !ls or !dir will list files in your current directory.

image

Sending a query to Vibe

Guardrails and permissions

Vibe is built to keep you in control. For substantial tasks (refactors, multi-file updates, cleanups), Vibe splits the work into steps it can execute safely and asks for confirmation before proceeding.

📌 You can cap the number of steps or set a maximum session cost. See the README for details.

Before editing files or running commands, Vibe shows a full preview and asks for confirmation.

image

Vibe showing a preview of changes and asking for confirmation

After each step, you see exactly what was executed and the resulting output.

image

Vibe displaying generated output and completed steps

Agentic capabilities

Vibe can run tasks end-to-end with more autonomy. Use --auto-approve when you want Vibe to execute without prompting, or create a custom agent for repeatable workflows.

🚨 With --auto-approve and custom agents, actions run without confirmation. Use with caution.

Next steps

You’re ready to use Mistral Vibe in your terminal. Start with small tasks, try the interactive commands, and build up from there.

📌 Need help? Type /help, check the README, reach out on the Mistral Discord, or contact our support team 💬.

Did this answer your question?