---
id: mistral-vibe
version: "2.24.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# mistral-vibe — Minimal CLI coding agent by Mistral

License: permissive · Maintenance: active · Downloads: 7.3M/mo

## What it is and what it does

Mistral Vibe is a conversational CLI agent that sits in your project directory and lets you explore, modify, and interact with your codebase using natural language. It wraps Mistral's language models with a suite of built-in tools—file read/write/patch, shell execution, grep-based code search, git integration, and task delegation to subagents—so you can ask questions like 'find all TODOs' or 'refactor this function' and have the agent execute the work with your approval. It's project-aware, scanning your file structure and git status to provide context, and highly configurable through a config.toml file where you can choose agent profiles (ask, plan, accept-edits, auto-approve), set default models, and manage tool permissions.

The package targets UNIX environments (Linux and macOS) though Windows is supported. It requires a modern terminal emulator and Python 3.12+. Installation is straightforward via pip or uv, and the first run prompts you for an API key. The tool is designed for developers who want an interactive, approval-gated AI assistant in their shell rather than a separate IDE plugin or web interface.

Use it for:

- Search and explore a large codebase using natural language queries without manually navigating files.
- Delegate code refactoring tasks to the agent with auto-approval for safe edits only, reducing manual review overhead.
- Ask the agent to analyze project structure and architecture while you work on something else using task delegation.
- Use the read-only 'plan' agent to understand unfamiliar codebases before making changes.
- Execute shell commands and file operations through natural language prompts with approval gates for safety.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Mistral Vibe is a command-line coding assistant that lets you interact with your codebase using natural language, with tools for file manipulation, code search, version control, and command execution.

Yes. Mistral Vibe is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It's well-suited for developers who want an AI coding assistant integrated into their shell workflow. The main gotchas are the Python 3.12 requirement, the need for a modern terminal, and the 97 runtime dependencies—evaluate those against your environment. If you're comfortable with those constraints and have a Mistral API key, it's a straightforward install.

## Install

pip install mistral-vibe
uv add mistral-vibe
poetry add mistral-vibe

## Installing mistral-vibe

Before you install: Low friction: pure Python wheel with no compiled dependencies. Active maintenance—last release 3 days ago, 4826 GitHub stars, and continuous updates since first release in November 2025.

License in practice: Apache-2.0 is permissive; you can use, modify, and distribute Mistral Vibe freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install mistral-vibe
vibe
# Then at the prompt: grep(pattern="TODO", path=".")

Requires Python 3.12 or later. Requires a modern terminal emulator (WezTerm, Alacritty, Ghostty, or Kitty recommended). Requires Mistral API key configured via vibe --setup or environment.

Verify before relying:

- Whether the 97 runtime dependencies introduce supply-chain risk or stability concerns beyond what the fact sheet shows.
- Whether voice mode and custom slash commands via skills are fully documented and stable in production use.
- Whether the agent's tool approval system and safety features have been independently audited.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 7.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cli coding assistant, ai code exploration tool, command line llm agent, codebase chat interface, mistral ai developer tool, natural language code search, interactive shell agent, ai-assistant, cli-tool, code-exploration

[View on SkillFed](https://skillfed.io/packages/mistral-vibe) · [View on PyPI](https://pypi.org/project/mistral-vibe/)