NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #3101 most downloaded on PyPI
Minimal CLI coding agent by Mistral
Latest stable
3.1.2
Last release 12 days ago
10 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
1 years old
100 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Installed plugins can be turned off with the disabled_plugins setting: a disabled plugin stays installed but contributes nothing to sessions
disabled_plugins setting: a disabled plugin stays installed but contributes nothing to sessionsdefaultEnabled: false in their ai.mistral.vibe extension) and turned on with the enabled_plugins setting/skills lists your installed skills, one row per name, with search, a Space toggle to turn each one on or off, and the highlighted skill's body under the list or beside it on wide terminals./skills lists shared skills to add on a Shared tab and lets you pin a version or alias per scope, preview each version, unpin a scope, or remove the skill.skill_paths.Your coding agent can read these notes before it upgrades. Set up the MCP server →
vibe-acp notifies the client when the administrator changes the organization's Vibe Code configuration.
vibe-acp notifies the client when the administrator changes the organization's Vibe Code configuration.vim_keybindings config optionenable_sticky_prompt = false turns the pinned prompt offpre_agent hooks run before the model reads a user message: they can block it, rewrite its text, or add context for the model.notification hooks run in the background when Vibe needs your approval or an answer, or when a turn completes or fails.session_start hooks run when a session starts, resumes, is cleared or forked, and can add context for the model to the next message.session_end hooks run in the background when a session ends, with the reason (exit, clear or other)./vibe:import skill that finds your setup from other coding agents and imports instructions, skills, subagents, commands, hooks, MCP servers and permissions into Vibevibe -p reports each denied tool call on stderr and in the export's warningsvibe -p says on stderr when the agent finishes without an answerVIBE_SESSION=1 in their environment, so scripts can detect they run under VibeCtrl+Y pastes back the text last deleted with Ctrl+K, Ctrl+U, Ctrl+W or Alt+D.agentWorktrees client capability: its sessions get the enter_worktree tool, and before editing the user's checkout the agent asks whether to work in a new git worktree or in place. A session can hold several worktrees; each is listed in artifacts/list and cleaned up when the session is archived.[models.<old name>] settings apply to the model, and --model <old name> or the ACP model option picks it/pr lists the session's pull and merge requests with their number, title and state (green open, grey draft, purple merged, red closed)./pr, c opens the first failing CI check and f drafts a prompt asking the agent to fix what blocks the PR.vibe --resume now use the last 8 characters of the id; the first 8 still resume older sessions.notification and session_end hooks still running.bash command or a hook starts with & is stopped when it exits: long-running commands go through background processes./branch now works while the agent is running, forking the conversation as it was before the current turn, and shows the command that resumes the copy in a panel instead of the conversation.--yolo / --auto-approve on a new session now starts the auto-approve agent instead of a hidden bypass on ask, accept-edits or smart-approve, so Shift+Tab can leave it; the session resumes on that agent.active_model under the name the config file already uses for that model (during the catalog rollout), so older versions sharing the file still resolve itmistral-medium-3.5 runs the catalog's mistral-medium-latest when the catalog lists that alias)allowed_models patterns now also match a model's catalog aliases, so an allowlist written against a retired built-in's name (e.g. mistral-vibe-cli-*) keeps matching the catalog model that replaces itgh or glab); set enable_pr_monitoring = false (or VIBE_ENABLE_PR_MONITORING=false) to turn this offmy-plugin:review) instead of its tool namespace (my_plugin:review)enabled_skills or disabled_skills name plugin skills by the tool namespace (my_plugin:*) need the plugin name instead (my-plugin:*)/pr and refreshes the statuses; clicking it again closes the list.CI failing, changes requested, conflicts, CI running, review required), prefers the open PR over merged or closed ones, and reads bold until a new status has been seen.vibe -p --agent with an unknown or unavailable agent exits as a usage error (exit 1), and --agent plan says it was removed and names its replacementdefault_agent in the config that cannot start is reported as a configuration error/clear now starts a conversation with no scheduled prompts; the cleared session keeps its own and runs them again when resumed.~/.vibe contains invalid UTF-8 bytes.GIT_PYTHON_GIT_EXECUTABLE, which broke import git in containers or remote jobs where Git lives elsewhere./compact no longer fails and blocks the session when a warning arrives during the compaction, such as a cut-off summary.vibe doing nothing on Windows machines without the Visual C++ Redistributableapi_base is set, the admin-managed config and account links now use the deployment's chat URL instead of chat.mistral.ainpm install./context..git is reported once in the log instead of every few seconds.plugin.json field now load, with a warning, instead of being skipped.ai.mistral.vibe extension has an unknown key or declares volumes now keep their hooks, knowledge, and agents./teleport command is gone from vibe-acp./remote-project command is gone./teleport command, the & prompt prefix and the --teleport flag are gone; passing --teleport is now an error.experimental_enable_pr_monitoring and experimental_enable_pr_discovery settings and the VIBE_EXPERIMENTAL_ENABLE_PR_MONITORING variable are gone and now ignored; use enable_pr_monitoringpr can no longer be run as /pr, which now opens the built-in PR list.New enable_file_autocomplete setting (and VIBE_ENABLE_FILE_AUTOCOMPLETE) turns off @ file completion and its background file index.
/context command (also opened by clicking the footer's token counter) shows what fills the context window: system prompt, tool definitions, skills, conversation, free space and the auto-compaction buffer, with per-category token estimates.packages.mistral-vibe, an overlay and nix flake check checksread_file and see it, on a model that reads images.Ctrl+R searches your prompt history and loads the selected prompt into the input.experimental_enable_mistral_mcp_connector settingmistral-dark and mistral-light themes built from the Mistral brand palette.worktree_copy_on_write = false to turn this offexperimental_worktree_copy_on_write is renamed to worktree_copy_on_write, and existing configs are updated on startupmouse off (the default before tmux 3.8), Vibe leaves the mouse to the terminal, so its native selection and copy work without holding a modifier key.ctx 23k/600k.Ctrl+R to Ctrl+T./whoami now shows the last 4 characters of the API key instead of the first ones, matching Studioansi-dark and ansi-light themes, the input box and popup borders are dimmed so they stand out less.! shell command now also stops the processes it started, instead of hanging until they exitconfig.toml with a regular file/retry now works after interrupting a response with Esc, and says so when there is nothing to retry instead of doing nothing./clear, /resume, a rewind or a compaction, the footer and the PR/MR list show the new session's PRs and MRs.default_agent set in your config (for example auto-approve) is no longer replaced by smart approve when new sessions start./branch.nix develop builds again and ships the Rust toolchain it needsread_file refuses a binary file instead of returning it as unreadable text.smart_approve_default setting: set default_agent = "smart-approve" instead./release-notes (alias /whatsnew) browses the release notes of every Vibe version in a searchable, full-screen view.
/release-notes (alias /whatsnew) browses the release notes of every Vibe version in a searchable, full-screen view.preserve_api_base = true keeps a custom api_base that /whoami would otherwise overwrite (split-horizon / proxied deployments)VIBE_TERMINAL_KEY names the terminal --continue uses; an empty value makes it ignore the terminal/whoami shows which credential source (shell, .env, or keyring) is in use.vibe -p --system-prompt-file PATH replaces Vibe's own instructions in the system prompt with the file's text.agent_max_output_tokens and compaction_max_output_tokens cap the output of every agent and compaction request on any provider, held to what the model and its context window leave room for; at 0, the default, a cap is still sent only where the provider requires one.vibe -p --model ALIAS runs with that model without changing your default./fork alias for the /branch command, which forks the current conversation into a new resumable session.experimental_worktree_copy_on_write setting on macOS: new worktrees of a trusted repository are cloned from a template checkout, so they use less disk and are created faster/mcp always opens its panel, showing empty sections when nothing is configured or connectors fail to load.✓, ⚠ or ✕ status rows, and content commands such as /help and /status render like an assistant reply under their own heading.vibe-acp --setup now runs the same onboarding wizard as vibe --setup.N subagents waiting row; press a on the focused list to show all subagents.~/.vibe/tools/ or .vibe/tools/: each file now shows a warning at startup. Ask Vibe to migrate it to a skill.[tools.web_fetch] proxy_host, are now checked even when a custom tool of that name used them.vibe --continue reopens the last session of the current terminal in the current folder again, instead of the folder's most recent session from any terminalvibe -c -p continues a session of the current folder instead of the most recent session anywhere on the machineai.mistral.vibe/hooks.toml now run, from the session's copy of the plugin with PLUGIN_ROOT and PLUGIN_DATA set, like the plugin's MCP servers.--setup with a non-Mistral model (litellm, local) now offers Mistral browser sign-in alongside the provider's API key.default_timeout set without max_timeout_seconds loads again when it is at most 300 seconds, and runs under Vibe's 300-second maximum.Mistral-Vibe/<version> User-Agent again instead of the HTTP library default, unless extra_headers sets one.vibe: skills are now available in the standalone vibe-acp binaries.api_connect_timeout, api_write_timeout and api_pool_timeout settings no longer have any effect: connecting to the provider is now bounded by api_timeout.tool_paths setting: Vibe removes it from config.toml at startup and leaves the folders it listed on disk.Skills added or edited on disk are picked up by running sessions without /reload
/reload/model, /thinking or a resume./model while no turn is running, keeping the prompt being typed./ menu starts each skill's description with its scope (project, user or vibe), setting skills apart from built-in commands.post_agent hooks accept match to run only after a given agent, or after the main agent with match = "main".post_agent hook payload includes agent_name, the configuration name of the agent that finished its turn.outside_workdir = "deny" (global or per tool) refuses file and shell access outside the working directory with a tool error instead of a prompt, so the agent keeps working.strict_config = true (or VIBE_STRICT_CONFIG=1) to make Vibe refuse to start when your config has settings it does not use. A VIBE_STRICT_CONFIG value that is not on or off, such as 2, is refused toovibe config schema prints a JSON schema of every setting, including each built-in tool's settingsVIBE_CUSTOM_CONSOLE_URL to pin the console URL: VS Code and Vibe CLI sign-in is prefilled with that console, redirected into its normal login flow, and the domain can no longer be changed. The value may be a full URL or a bare domain; scheme-less values are upgraded to https:// (an explicit http:// is kept) and trailing slashes are stripped. A split-horizon API base configured for the pinned console is preserved.artifacts/markViewed app-server RPC: marks a session's artifacts (PRs/MRs) as viewed, persists viewed_at into the session logs, and announces each newly marked artifact with an artifacts/updated notification (Phase 3, Desktop artifact panel)gh pr list --head / glab mr list --source-branch) are now discovered at session load and recorded in the session logs, behind the experimental_enable_pr_monitoring feature flag (shared with PR/MR creation detection)PR #123 / MR !7) that opens it in your browser, or a PRs (n) count link that opens a modal listing every artifact with its linkgh pr create / glab mr create) are now detected and recorded in the session logs, behind the experimental_enable_pr_monitoring feature flagartifacts/sync RPC; the bottom bar and artifacts modal render the status and the per-check list/theme, /log-level, /voice, /proxy-setup and /remote-project now work while the agent is busy or prompts are queued.main is no longer loaded: the name is reserved for hook matching.permission = "always" now ask before reaching paths outside the working directory, like file tools.cat link, as a path, so a link pointing outside the working directory asks or is denied like any outside path.voice extra to build them from source.vibe -p runs and their export. A server without a connector service (self-hosted, Private Cloud) has no connectors rather than a failure to load them./mcp login command to run.auto_compact_threshold = 0 is now a config error; set a positive threshold or remove it to use the model's defaultauto_compact_threshold must fit the model's range; an old -1 is removed when the config loads, so the model's default appliesstream_options.include_usagethinking uses the model's lowest level; off is refused on models that always reason, such as gpt-6-astra and GLM 5.3off turns thinking offxhigh thinking level is offered for models that list itmax_output_tokens no longer caps replies; it is only sent to providers that require an output limit[Image] in place of each image, followed by the image's file link when it has one, so the agent can open it; opening or switching to such a model in a session that holds images shows a warning. Images stay in the session, so switching to a model that reads images sends them again[Image], without their file linklean profile are now refused as config errors. An agent file with such a setting, or any other invalid one, now gives that error when you choose it, instead of "Agent not found".default_timeout = 300, written by Vibe's first run, keep loading: Vibe drops that line and uses its default bash timeouts.lean profile, the shell runs commands with 1200 s by default and at most 1200 s, on Windows too./ menu no longer lists a skill named like a built-in command, such as /retry, which always ran the built-in.vibe-path: grants and path globs, now cover paths reached through system symlinks, such as /tmp on macOS./reload now reaches custom subagents that are already running, on their next tool call.-p, instead of being dropped silently.active_model selects instead of the session's model; a model they cannot use is reported instead of silently replaced./clear no longer fails with plugin_pin_mismatch when an installed plugin was upgraded while the CLI was running; the cleared session carries its pinned plugin environment forward.@ file completion no longer hangs on a stuck git fsmonitor daemon, and no longer runs a repository's core.fsmonitor command[Image] instead of failing the turnconfig.toml does not parse, app-server clients such as the desktop app now get the parse error when they list agents, skills or settings, instead of an internal errorrustls dependency to address an upstream security advisory.max as max, high as high), never silently changed$current_date placeholder.config.toml now apply with the unified harness, and the model is told them.config.toml, such as max_timeout_seconds = "1800", no longer crashes session start.max_timeout_seconds, after you lowered it or switched to an agent with a lower one. That call fails as a new one would, and the session goes on. A saved shell call without a timeout runs with the current default_timeout, as a new one would, instead of 120 s.lean, now says why after "Invalid configuration edit" instead of stopping there./reload of a config.toml that breaks a config rule, such as setting default_timeout without max_timeout_seconds, now reports the config error naming the setting, and the session keeps the config it has.compaction_thinking setting: compaction uses the compaction model's thinking levelcompaction_max_output_tokens and output_token_reserve settingsinclude_model_info and include_prompt_detail no longer do anything; Vibe warns if your config still sets themenable_mouse_capture setting (or VIBE_ENABLE_MOUSE_CAPTURE=false) to leave text selection and copy to your terminal; depending on the terminal, some o
enable_mouse_capture setting (or VIBE_ENABLE_MOUSE_CAPTURE=false) to leave text selection and copy to your terminal; depending on the terminal, some other mouse interactions such as clicks are disabled too.max_subagents and max_concurrent_subagents settings to control how many subagents can be alive and running at onceNot connected and connect in one click, instead of asking an admin to set them up.--agent to pick a mode your organization disabled now opens your default starting mode (your organization's, if it sets one) and shows a notice.hooks.toml now run for tool calls made inside subagents, including post_agent hooks, as they do for the main agent.[tools.*] permission, allowlist and denylist now apply to its tool calls, on top of the main agent's rules, instead of being ignored.enabled_skills and disabled_skills now limit which skills it can load, instead of being ignored./reload now stops enforcing settings your organization has removed.@ file completion no longer misses files and folders in large workspaces[tools.grep] settings and a tools/prompts/task.md description override have no effect, instead of ignoring them silently.-p or --prompt-file no longer hang when stdin is left open.New enable_auto_approve setting: when the admin-managed config sets it to false, the auto-approve (YOLO) mode is forbidden — the auto-approve agent (a
enable_auto_approve setting: when the admin-managed config sets it to false, the auto-approve (YOLO) mode is forbidden — the auto-approve agent (and any custom agent with safety = "yolo") is hidden and --auto-approve/--yolo plus bypass_tool_permissions are ignored. Per-tool permissions still apply.compaction_max_output_tokens (80000), compaction_thinking (unset), compaction_reasoning_limit_tokens (32000), output_limit_retries (6) and output_token_reserve (4096) settings tune compaction requests and recovery from answers cut off at the output limit.session/subagents/wait, session/subagents/interrupt and session/subagents/read methods: a client can wait for the subagents a turn left running, interrupt them, and read each one's status, store, model, usage, cost and stepsvibe -p waits for the subagents its turn left running before it exits; --time-limit and other stops interrupt them, and the --output-dir export lists each subagent with its status, model, usage, cost and steps, and copies its journalpricingModel, pricingFallback)--agent-socket server's tools/call names its caller, so the server can tell a subagent's call from the root'svibe run-server command: runs many vibe -p --agent-socket sessions from one process, on shared app-servers (--runs-per-app-server, default 16) that exit once idle, each run with its own config, credentials, limits and export/model and the /config model list now group models by where they come from: your organization, experiments, the model catalog, then your own config.tools.bash.default_timeout and max_timeout_seconds are unset unless set in config.toml; the native shell tools still default to 300 seconds, at most 600 or the default when that is longer.default_timeout above its max_timeout_seconds is now a config error naming both, instead of being lowered to the maximum.read_file reports the file's line count and where to read on, and an offset past the end is an error.read_file on a directory lists its entries, up to 500 at a time, instead of failing.read_file and file mentions return up to 64,000 bytes a call instead of 51,200, the same as the Agents SDK.api_timeout instead of hanging the session.VIBE_* environment variable such as VIBE_MODELS is now ignored and logged instead of stopping Vibe at startup.--agent reopens on that agent.run_typescript now sees an MCP or connector tool's own error text instead of a generic message.enable_system_trust_store = true in config.toml, prompts now also use the operating system's certificates, so they work behind corporate proxies that only the OS trusts.not connected in /mcp instead of error - try refreshing, and pressing Enter connects them without visiting the dashboard.max_context_length no longer overflow its window: the output cap is clipped to the room the input leaves, less a 4096-token reserve.PATH entries that a login profile resets, and the profile runs once per session./dev/null.main, and no longer hedges the instructions a session starts with.vibe -p reports and prices themdisplayName in their ai.mistral.vibe extension now load their knowledge, hooks, agents and tool namespace instead of reporting an extension error.vibe -p exits only once its app-server has, and on Linux a killed vibe -p or vibe run-server takes its app-servers down with itvibe -p whose stdout closes early, as when piped into head, now ends the run as infrastructure_failure instead of crashing in text outputdisplayed_workdir, context_warnings and raise_on_compaction_failure are deprecated: they remain accepted in existing configs but have no effect on Uni…
/leanstall and /unleanstall install and uninstall the Lean agent.experimental_enable_model_catalog on, the model list includes Mistral's curated models, and your config can still override their settings./mcp blocks connectors that need your login and tells you to run vibe --setup./branch forks the current conversation into a new resumable session./status shows the credential source in use and the shadowed sourcesenable_mcp flag to block all user-facing MCP server operations (add, remove, toggle, login, logout, tool registration), including plugin-provided MCP servers, via managed config.read_file shows a file's line endings as they are on disk, like shell commands dowrite_file writes new files with the line endings it is given, also on Windowsvibe-app-server instead of python3 in Activity Monitor, ps, and top.-p) now follows the Python CLI's run contract, with turn, token, price and time limits, graceful stops, and a JSON run export whose exit code reports the outcome.subagent.* to agents.*, and sessions saved with the old names still resume.agents, agent or collaboration tool namespaces, which are reserved for built-in agent tools.enable_system_trust_store or use a compliant CAvibe -p JSON and streaming output mark each completed assistant message and reasoning with an outcome: committed, or discarded with its cause.#, an escaped quote, or PowerShell quoting to hide part of the command from the approval check./resume and the Desktop session sidebar) is several times faster when you have thousands of sessions.bg twice no longer exits the CLI with an interrupted-syscall error./mcp add, login, logout, and status errors now show the server's reason./rename usage tip and /mcp add --help show their <...> placeholders instead of dropping them.vibe -p forever: the read gives up after 60s and the error says the Keychain could not be read instead of reporting a missing key.-p runs announce on stderr when the API key comes from the keyring, fail if startup stalls, and print the server's error instead of a bare session/start.ą) are no longer dropped.vibe -p --resume SESSION_ID continues that session instead of being rejected or starting a new one/c/... paths in shell commands instead of retrying several path spellings./resume now confirms which session was deleted./config now shows an error toast with the server's reason when saving or loading a setting fails, instead of silently doing nothing.post_agent hook is configured, instead of appearing all at once when the turn ends.title_prompt_id setting now also applies to session titles in Vibe Desktop and in the CLI's default harness.vibe update prompt without a terminal (e.g. nohup vibe > /dev/null 2>&1 &) now exits with an error instead of running forever at full CPU.grep or rg shell command run by the agent shows its matches as a file-search result with clickable file chipsVIBE_CLI environment variable: vibe always starts the Rust TUI.plan agent and the exit_plan_mode tool./leanstall and /unleanstall install and uninstall the Lean agent.experimental_enable_model_catalog on, the model list includes Mistral's curated models, and your config can still override their settings./mcp blocks connectors that need your login and tells you to run vibe --setup./branch forks the current conversation into a new resumable session./status shows the credential source in use and the shadowed sourcesenable_mcp flag to block all user-facing MCP server operations (add, remove, toggle, login, logout, tool registration), including plugin-provided MCP servers, via managed config.experimental_enable_model_catalog on and no model picked, Vibe runs the catalog's recommended model.read_file shows a file's line endings as they are on disk, like shell commands dowrite_file writes new files with the line endings it is given, also on Windowsvibe-app-server instead of python3 in Activity Monitor, ps, and top.-p) now follows the Python CLI's run contract, with turn, token, price and time limits, graceful stops, and a JSON run export whose exit code reports the outcome.subagent.* to agents.*, and sessions saved with the old names still resume.agents, agent or collaboration tool namespaces, which are reserved for built-in agent tools.enable_system_trust_store or use a compliant CAvibe -p JSON and streaming output mark each completed assistant message and reasoning with an outcome: committed, or discarded with its cause.bash tool (Git Bash, otherwise PowerShell) instead of cmd.exe#, an escaped quote, or PowerShell quoting to hide part of the command from the approval check./resume and the Desktop session sidebar) is several times faster when you have thousands of sessions.bg twice no longer exits the CLI with an interrupted-syscall error./mcp add, login, logout, and status errors now show the server's reason./rename usage tip and /mcp add --help show their <...> placeholders instead of dropping them.vibe -p forever: the read gives up after 60s and the error says the Keychain could not be read instead of reporting a missing key.-p runs announce on stderr when the API key comes from the keyring, fail if startup stalls, and print the server's error instead of a bare session/start.ą) are no longer dropped.vibe -p --resume SESSION_ID continues that session instead of being rejected or starting a new one/c/... paths in shell commands instead of retrying several path spellings./resume now confirms which session was deleted./config now shows an error toast with the server's reason when saving or loading a setting fails, instead of silently doing nothing.post_agent hook is configured, instead of appearing all at once when the turn ends.title_prompt_id setting now also applies to session titles in Vibe Desktop and in the CLI's default harness.vibe update prompt without a terminal (e.g. nohup vibe > /dev/null 2>&1 &) now exits with an error instead of running forever at full CPU.grep or rg shell command run by the agent shows its matches as a file-search result with clickable file chipsnpm scripts, fail on prompts instead of hanging, and show non-ASCII output correctlycommand string contains a backslash path now startVIBE_CLI environment variable: vibe always starts the Rust TUI.plan agent and the exit_plan_mode tool.The app-server reports which process holds a stored session, and pushes a change when that process lets go of it, so a client can show a session open
/proxy-setup.speaking status row that Esc or Ctrl+C stops./plugins browses the session's plugins, and /reload-plugins re-pins them and reports what changed./model and /thinking pickers, s applies the selection for the current session only, while Enter still saves it to your config.nix run .#rustCli to launch the Rust terminal instead of the Python one/whoami shows the start of your API key, its scope, and its access scope.enable_background_processes = false stops the agent from starting background processesenable_subagents = false takes subagents away from the agent on the default runtime.cursor_blink = false or /config, keeping a steady caret in both Python and Rust terminals.export.json records steps, the number of model calls the agent madeexport.json lists the session's config issues, such as a skill it could not load, under warningsvibe -p reads the prompt from --prompt-file or stdin, and --output-dir writes an export.json and the session journal on every exit.vibe -p --time-limit SECONDS stops the run at a deadline; SIGTERM and Ctrl-C stop it the same way, and the session can be resumed.top_p and max_output_tokens config settings.experimental_enable_model_catalog config flag (default off) — groundwork for the upcoming model catalog, no visible effect yet.api_stream_idle_timeout setting (off by default) fails a model response that goes silent for that many seconds.vibe -p --agent-socket sessions run background processes in their POSIX sandbox, as enable_background_processes says, instead of always turning them offtitle_prompt_id config setting to override the prompt used to generate session titles: built-in session_title or a custom .md file from ~/.vibe/prompts/ or .vibe/prompts/./status shows token counts in a compact form (e.g. 1.23M) followed by the exact value, dimmed, with thousands separators.12.5k instead of 12k)./config, /mcp, /plugins and the project picker search with /; Esc leaves the search, then clears it, then closes. /plugins now shows its search field under the title, like /mcp and /config.› marks the current value./whoami and the banner even when the active model isn't a Mistral model./, ! or & over a fully selected input switches to that mode, and so does pasting a /command or !command into an empty input.VIBE_CLI environment variable to python."experimental_enable_document_library_connector config flag (off by default) while its tools stabilize.vibe -p exits 1 on usage or config errors, 2 on infrastructure failures and 3 when a limit or a model refusal stopped the agentvibe -p --max-turns now exits 3, not 1, when the agent reaches the turn limit; so do --max-tokens and --max-price, including when the budget ran out as the agent finishedCtrl+G opens the current input in $VISUAL / $EDITOR and loads the saved text back./reload-plugins now offers the skills of a plugin installed during the session, without a restart./ mode with the caret at the end and that skill highlighted in the completion menu./clear resets the context window display right away instead of keeping the previous conversation's usage until the next turn./, ! or & added before an existing message, or after leading spaces, is sent as a message instead of running a command, and stays one when rewound or edited in the queue./, ! or & input leaves the mode and keeps the text.vibe -p no longer offers the cron tool, whose calls always failed in a headless session.--experimental-harness turns no longer re-state scratchpad notes into prompts, so they no longer add <vibe-scratchpad> blocks to the transcript.The app-server can discover built-in plugins from roots an embedding application ships, alongside the ones inside the package.
~/.vibe/.env fallback for the API key when the OS keyring is unavailable is now created owner-only (0600), so a saved key is no longer readable by other accounts on the machine.--setup runs it and exits./teleport, &<prompt> and --teleport send the session to Vibe Code Web, with push approval and Esc to cancel./voice./loop and model-managed cron tools.vibe update and --check-upgrade ask the install's own package manager (uv, Homebrew, or PyPI) what it can deliver and prompt to upgrade the CLI.enable_system_trust_store — bundled Mozilla roots by default, the OS trust store when enabled.thinking_levels field to offer only the thinking levels they support./mcp shows connector display names, plugin owners, and a link to add connectors in Studio./mcp <name> also accepts the display name shown in the browser, and unknown names list those display names.max_context_length setting, editable in /config./skill-name, with the same caret-based completion popup as @ file mentions./skill and @file completions and pasted images are highlighted in the prompt and edited as a single unit.[Pasted n characters] placeholder, also once sent or rewound; paste the same text again right away to show it in full./resume preview loads its older messages automatically.VIBE_CLI (or setting it to python) switches to the legacy Python TUI.VIBE_CLI selector, including the Windows session-variable forms, for running the legacy Python TUI./loop, /mcp, /rename) until the first argument is typed../ command in its mcp.json./status shows the active model, provider, and API base.[utility_models] in your config; active pins a feature to the model your session runs.workspace/git/worktrees/remove gained additive inspect, force, and deleteBranch params plus branchCreated/holders response fields, so a client can probe a removal before committing to it.session/updated before the session moves, so clients that gate their UI on it can proceed as soon as it exists.permission = "never" now denies a sensitive path instead of prompting for it.vibe, vibe-acp, and vibe-app-server executables now always ship the Unified Runtime; a build that cannot collect it fails instead of producing a legacy-only binary.[Image #N] placeholders instead of their file path./resume picker takes at most 40% of the screen height.session_logging.generate_titles = false) and run on the session's own model and provider.[utility_models].~/.vibe/worktrees.subagent or skill namespaces./clear shows the previous session id and how to resume it./retry hint work; request telemetry carries attachment counts again.permission = "never" with an allowlist now writes where the allowlist permits, instead of refusing everythingplan agent can write its plan file againask_confirmation_on_exit, and the quit hint names the pressed key and warns about queued messages./mcp also reloads workspace connectors and no longer piles up requests or floods the transcript with errors./mcp still re-discovers MCP servers when workspace connectors fail to load./mcp toggles roll back only their own row with a warning, enabling no longer shows a status early, and plugin servers cannot be toggled./mcp <name> on a server that needs auth opens its login instead of an empty panel./mcp source that starts needing auth opens its login instead of an empty panel.Connecting... until /mcp reopens instead of going blank./mcp no longer offers Connect on a source whose bootstrap failed./mcp reports when connectors fail to load instead of saying nothing is configured./mcp errors keep their line breaks instead of running together./mcp no longer fails once the connector cache is over ten minutes old./mcp shows tools disabled by the global disabled_tools/enabled_tools patterns as disabled.! shell command keeps the raw path.! shell commands stay in the transcript after an app-server restart or session resume on the experimental harness.exclude-newer.@ mention per file./paste-image insert the images copied in Finder instead of their icon.vibe-pasted-images/clipboard-<timestamp>.png, like the Python CLI.Rust CLI: support for configuring Vibe Code remote projects
Copied inline notice, and only when autocopy is enabled.hideOther) is open now anchors from every box row instead of none./leanstall and /unleanstall now work on the unified backend instead of failing/leanstall and /unleanstall no longer crash the TUI on the unified backend~/.vibe/agents or .vibe/agents can be spawned againsystem_prompt_id runs on that prompt instead of the defaultrun_typescript program, instead of staying frozen until the program finishes.Allow /teleport with Vibe and workspace API keys, including free accounts, without an internal feature gate.
Vulnerability disclosure guidance and private reporting instructions in SECURITY.md.
--experimental-harness sessions can track todos, shown as a pinned line under the input and in full on /todo, and keep a per-session scratchpad whose notes are re-stated to the agent after the conversation is summarised./skills browser without removing it.vibe mcp add --allow-insecure-http and /mcp add --allow-insecure-http opt into plaintext http:// MCP servers on non-localhost hosts, such as a server on the LAN.r in the MCP servers & connectors panel to refresh the list on demand.--legacy-harness is the documented escape hatch back to the legacy Python harness.session_logging, project_context and experiments, rather than the whole group. Keys an admin does not set are taken from the user's own config instead of being reset to defaults.MistralAI-VibeCLI/<version> User-Agent header on MCP HTTP requests, letting the connectors gateway distinguish Vibe CLI tool calls from other MCP clients.session_logging.enabled = false is honoured again on the Unified Harness: the conversation and its attachments no longer land in the session save directory, the session log summary reports that logging is off, and --continue/--resume are refused with the same message the legacy backend gives.pre_tool and post_tool hooks now run for the skill tool, which previously took no hooks at all.&&, redirects, globs or $VAR now run through the shell.match now matches the tool the model actually calls, including edit and MCP tools./mcp login now recovers when a stored OAuth token refresh fails transiently (e.g. the server returns 5xx); it discards the stuck credentials and retries a fresh authorization instead of failing every retry.sort --files0-from now requires approval before reading listed files.ls 2>&1 or make >/dev/null, no longer ask for approval. Redirections that write to a file still do..vibe/ or .git/ configuration; it still asks before writing one.…could bypass workspace and denylist controls (CVE-2026-87984, CVE-2026-87985, CVE-2026-87986, CVE-2026-87987, and residual CVE-2026-87988 variants).
@ file mentions now resolve against every workspace root, including --add-dir ones.@ mention outside the workspace no longer rejects the whole message; it stays plain text and the read tool can still ask for it.--add-dir no longer drops the working directory from the file tools' workspace roots.New /branch command forks the current conversation into a new resumable session, leaving the current session unchanged. Resume the copy in another ter
/branch command forks the current conversation into a new resumable session, leaving the current session unchanged. Resume the copy in another terminal with vibe --resume <id>.VS Code extension: debug submenu with log level picker, open log file, and a togglable session status panel showing agent statistics (steps, tokens, t
SessionBackendKind literals from "python"/"rust" to "legacy"/"unified" to match backend identity naming.~/.vibe now warns instead of passing silently: ConfigOrchestrator.set_field returns its errors rather than raising, so an ignored failure looked exactly like a successful write and the next session asked again with nothing to explain why.Desktop keeps 15 recent managed Code worktrees by default, configurable in Local Coding settings; cleanup skips active, dirty, untracked, or unpushed
/reload is in progressexperimental_enable_tab_status config option: shows >> (running) and ? (waiting) indicators in the terminal tab title.worktree plugin with a skill for creating, reusing, and cleaning up git worktrees under $VIBE_HOME/worktrees.env var MISTRAL_API_KEY, the keyring), so a shell-exported key shadowing the one saved at setup is visible.vibe and skill-creator skills now reach a session as skills of the shipped vibe plugin, so they are offered once, as /vibe:vibe and /vibe:skill-creator.session_logging.generate_titles = true to re-enable them.! command directly in the timeline: it is neither folded behind its own toggle nor gathered into the summary line that folds the agent's tool calls. Shell calls the model makes still fold, as every other tool result does./plugins detail view now leads with Author and Version, then the description, then Location (renamed from "Installed from"), Scope, Format, and Pinned./resume session picker now shows an animated loading indicator while saved sessions are discovered and waits briefly before loading a highlighted session preview, keeping rapid keyboard navigation responsive.git worktree add lands, so the session exists from the moment the prompt is sent instead of after the checkout. Only its first turn waits.DEBUG_MODE=true under vibe-acp/retry, which could only fail again with the same key./plugins with "Plugin namespace 'vibe' is reserved". Only a built-in may claim the reserved vibe namespace, but the re-resolve a session's plugin bind performs was re-reading every checkout at project scope, so the shipped vibe plugin was dropped from every session.! command that exits non-zero (or is interrupted) now shows what it printed. Only the exit status was reported before, which hid the stderr explaining it.~/.vibe/plugins/) were shown as project scope in /plugins because the bind-time resolve collapsed all staged checkouts to project scope. Scope is now preserved from the original discovery.git diff/show/blame, git log -p, git status -v); they defer to the classifier so a secret shown in a diff is not auto-readcd prefix (e.g. cd ~/.ssh && ls); the secret scan now reads the whole command, not the part after the cdui.ask_user_question; asking the user a clarifying question is the escalation channel itself, so it always runs instead of paying a classifier round-trip, being deny-and-continued, or escalating to an approval dialog to ask--smart-approve now keeps the mode in the Shift+Tab cycle for the whole session; it was selected at launch but dropped out of the cycle after switching to another mode, so you could not switch back to itprovided_tool_mode--check-upgrade and update, instead of an internal store-format validation error./skills browser for session skills, with search and filter; shared skills sync on session start. Experimental, off by default.
/skills browser for session skills, with search and filter; shared skills sync on session start. Experimental, off by default.browser_auth_allow_origin_rewrite rewrites sign-in/poll URLs onto configured origins/mcp, tagged with their plugin and authenticatable via /mcp login; a pending login is announced at session startask_user_question and exit_plan_modevibe update to check for and install a newer releaseagents/list no longer requires a session id/skills browser groups by scope, fits rows to width, and pages long listsvibe --yolo selects the auto-approve profile (cyclable with Shift+Tab; blockable via disabled_agents)[[mcp_servers]] entry is dropped with a warning instead of inheriting the configured credential/config saves to user config by default; Tab cycles user / session / (trusted) project target/mcp title marks an in-flight background refreshbrowser_auth_api_base_url port/whoami/mcp layout; rows render the first line only, [source] prefix stripped--yolo, --auto-approve, bypass_tool_permissions)vibe skill no longer recommends the removed /terminal-setup and now documents /copy, /paste-image, /remote-project/clear and /compact/config shows and edits the active model's effective auto-compaction threshold, preserving org-enforced global locksmove from a field relocation/mcp login no longer probes with a bare GET (405 before credentials); for a plugin server it sends the plugin's declared headers and uses its own URL, not a same-named [[mcp_servers]] entry from another session/mcp add under a plugin-owned name takes the name immediately for the configured entry/mcp refresh reconnects plugin servers, not just configured ones/mcp row with their own status and tools[[mcp_servers]] entry under a plugin-owned name no longer strands the plugin's server[[mcp_servers]] entries; each session's configured servers are its own/mcp no longer paints a failing-discovery source or unlinked connector as enabled before it comes upNoMatches/mcp opens from cache and waits 60s before refreshing; HTTP setup runs outside the UI loopdevstral-small-latest) from the default models list; stale sparse config overrides migrated automaticallyFuzzy search in the MCP servers and connectors browser
--worktree or --trust already grants accessSlash commands and setting pickers can be used while the agent or a command is running
Custom tools are flagged as deprecated
/log-level command for runtime log-level control/retry is exposed to ACP clients/ and supports ../ traversalInline ghost-text completion for mid-prompt skills
/clear and /new accept an optional first prompt and show the resume idask and defaults to accept-edits<cwd>/.vibeC:\c\... directories on Windows/clear resume hint gated on session persistabilityAdmin config layer for shared/enforced config that applies over user config
/model and /config to track the recommended model without pinning a specific alias_session/retrying notificationvibe.startup)autocopy_to_clipboard documenteddevstral-small thinking setting migrated to offmax_turn_requests stop reason instead of erroring on turn limit/resume listing speed no longer scales with total session count (persistent index)/retry command to retry an interrupted response
/retry command to retry an interrupted response/rewind now lets you choose between forking and rewinding in place/status shows provider prompt-cache usage and discounts cached tokens from the session costSkill-creator built-in skill: a guided flow to author, update, and delete your own skills
/config as a searchable, full-screen settings browser with typed edit modals and per-layer origin displayvibe-app-server binary for desktop integration.tar.gz archivesgrep result chips open the correct file and no longer leak absolute host paths into context (ACP)/rewind truncates in place instead of forkingCrash when @-mentioning a file, which aborted the turn
@-mentioning a file, which aborted the turn[A/B testing] OS-native managed shell tools
vibe mcp add and vibe mcp remove commands to add and remove remote MCP servers without editing TOML-p, ACP) and the core engine, replacing direct AgentLoop/callback coupling with a typed, projected protocol/resume delete confirmationLC_CTYPE used instead of LC_ALL in the bash tool environmentOSError on over-long @-mention autocompletion candidates/mcp add/new command as an alias for /clear
/new command as an alias for /clearDefaultConfigLayer; config.toml stores only user-set valuesread_file no longer prompts for approval on plan files in plan modeRegistry skills content store and manifest for skill discovery
hooks.toml is now stable. Every hook type is renamed: post_agent_turn → post_agent, before_tool → pre_tool, after_tool → post_tool (the hook_event_name payload field is renamed to match). Update existing hooks.toml files accordingly.@file mentions now inject as read_file tool callsdecode_safeSKILL.md before parsing frontmatter/dev/tty is unavailable@file mention suggestions stretched to full widthcopy() for forkingenable_experimental_hooks config flag (and VIBE_ENABLE_EXPERIMENTAL_HOOKS env var); hooks now load unconditionally when declaredWarning when the Narrator is enabled without working audio output
Esc when the input is empty, with improved keybindingsask_user_question selection now works via mouse and supports free-text entry/exitExperimental managed bash tool for running and tracking shell sessions
--disabled-tools CLI flag to turn off specific tools for a run<tools-dir>/prompts/<name>.mdAGENTS.md files are now surfaced during read_file tool callsNO_PROXY--worktree NAME option to create or reuse a git worktree and run inside it
--worktree NAME option to create or reuse a git worktree and run inside itQuestionApp when submitting an empty multi-selectWhole-line content now shown in the edit diff
--continue now matches the resolved working directorymcp_servers names in config are now rejecteddefault_agent on new and resumed sessionsj/k navigation in selectable lists across the TUI (questions, theme picker, rewind, voice, MCP panels)
j/k navigation in selectable lists across the TUI (questions, theme picker, rewind, voice, MCP panels)ask_confirmation_on_exit config option to prompt before quitting.vibe/config.toml now persists config option changesask_user_question now supports more than 4 options and questions/mcp add slash command for adding OAuth MCP servers
/mcp add slash command for adding OAuth MCP serversClickable URLs in web fetch and web search tool output
/mcp panelCommands in /help are now listed alphabetically in both the CLI and ACP
/help are now listed alphabetically in both the CLI and ACP/teleport is now always available and shows an explicit error when its prerequisites aren't met, instead of being hidden/mcp login, /mcp logout, and /mcp status commands to authenticate OAuth-backed MCP servers from the TUI
/mcp login, /mcp logout, and /mcp status commands to authenticate OAuth-backed MCP servers from the TUIvibe --check-upgrade to force an immediate update check and exit--yolo as an alias for --auto-approveACP workspace trust gated behind the workspace-trust client capability
workspace-trust client capability/resume now opens much fasterFuzzy search in slash command autocomplete
/resume now scopes the session picker to the current foldermax_tokens instead of surfacing internal errors[Experimental] before_tool and after_tool hooks: shell scripts declared in hooks.toml that fire around every tool call; hooks can deny the call, rewri
before_tool and after_tool hooks: shell scripts declared in hooks.toml that fire around every tool call; hooks can deny the call, rewrite tool inputs, or append context to the output — enable with enable_experimental_hooks = true!bash command is running are queued and shown above the input; Esc pauses the queue, Ctrl+C drops the last queued message (LIFO), Enter flushes the queue when pausedls, cat, pwd, etc.) are allowed without approval by default[mcp_servers.auth] block in config for per-server MCP authenticationmax_turns support exposed over ACP via set_config_optionpost_agent_turn retries no longer use exit code 2; hooks must now exit 0 and return {"decision": "deny", "reason": "..."} on stdout to trigger a retry — exit code 2 is treated as a failure--resume now shows history when launched from a dangerous directoryweb_search are handled without crashing/teleport slash command exposed over ACP, mirroring the TUI command for IDE integrations
/teleport slash command exposed over ACP, mirroring the TUI command for IDE integrations/help instead of rejecting themsearch_replace name and now point to editImage attachments via @-mentions in the TUI for vision-capable models
@-mentions in the TUI for vision-capable modelssession/delete extension methodSKILL.md file fails to parse instead of silently dropping the skillEnvironmentLayer in the layered configuration, populated from VIBE_-prefixed environment variablesread and the file edit toolwrite_file is now create-only and refuses to overwrite existing filesagent-client-protocol to 0.10.1/mcp panel ordering now reflect which connectors are actually usable and the user's enable/disable choicesdisabled_tools from runtime is merged with the TOML configuration instead of replacing it, and is enforced inside ToolManager.get()shift+backspace and shift+delete now work in the chat inputtodo plan-update handler when the model's tool call failed validationenable_system_trust_store config flag to switch the shared SSL context to the OS trust store for corporate TLS / private CA setups
enable_system_trust_store config flag to switch the shared SSL context to the OS trust store for corporate TLS / private CA setupsSSL_CERT_FILE / SSL_CERT_DIR and the system trust store opt-inVS Code extension promo link in the CLI banner now points to the renamed mistralai.mistral-vibe-code extension
Custom compaction prompts via the compaction_prompt_id config setting, resolved from ~/.vibe/prompts/ or .vibe/prompts/
compaction_prompt_id config setting, resolved from ~/.vibe/prompts/ or .vibe/prompts/--max-tokens flag for programmatic mode (-p)_auth/status and _auth/signOut extension methods so IDE extensions can show auth state and sign the user outvibe.setup.auth to classify the active credential sourceOverridesLayer and ProjectConfigLayer for the layered configuration system-p) no longer auto-approves tool calls by defaultenable_experimental_browser_sign_in flag is no longer required (stale entries are silently ignored)/teleport to Vibe Code Web now carries the working diff and last commit, matching the legacy teleport/teleport help and completion copy to say "Vibe Code Web"Load skills from ~/.agents/skills so they can be shared across agents
~/.agents/skills so they can be shared across agents/mcp with needs auth / needs setup labels and start the OAuth flow from inside the CLIminimal system prompt variant for eval and trainingsearch_replaceenabled/total in the bannerPretty session titles that format @mention syntax for human-readable display
@mention syntax for human-readable displaySessionInfoUpdate on the first prompt so IDE session pickers reflect the title immediatelyTomlFileLayer, ConfigBuilder, and ConfigOrchestratorD/E shortcuts in the detail view when there are no tools to enable or disablebash tool calls in ACP each render their own live terminal instead of racing on shared stateDeprecate retrying workflow status and expose retry source
--add-dir flag to pull additional repository roots into a session--no-autofill flag for bump_version.py script--continue scoping to current terminalenable_connectors config flag to control connector availabilitySyntax-highlighted file diffs for write_file and search_replace in the IDE agent webview
write_file and search_replace in the IDE agent webview! (bang) command outputprepare release script can resume after resolving merge conflicts/loop command to run a prompt or slash command on a recurring interval
/loop command to run a prompt or slash command on a recurring intervaldefault_agent config settingteleport command--helpenable_telemetry now takes precedence over enable_otelread_file flagged as truncated when the limit is reachedenable_telemetry takes precedence over enable_otel/rename command to rename the current session
/rename command to rename the current sessionfeat: vibe.at_mention_inserted telemetry eventvibe.ready telemetry fires soonerbash (!command) bang commands run via async subprocess for better latencymistral SDK to 2.4.4cryptography to address upstream CVEsnon_retryable flag on exceptions raised through _chat / _chat_streaming, so callers driving the agent loop from a Temporal activity can signal "do not retry"/clear no longer chains parent_session_id to the previous sessionvibe.new_session telemetry no longer fires when resuming a session/rename command to rename the current sessionfeat: vibe.at_mention_inserted telemetry eventvibe.ready telemetry fires soonerbash (!command) bang commands run via async subprocess for better latencymistral SDK to 2.4.4cryptography to address upstream CVEsnon_retryable flag on exceptions raised through _chat / _chat_streaming, so callers driving the agent loop from a Temporal activity can signal "do not retry"/clear no longer chains parent_session_id to the previous sessionvibe.new_session telemetry no longer fires when resuming a sessioncryptography)### Fixed - Fix textual version
Teleport surfaces the latest GitHub connection status while polling
Connector OAuth authentication flow in /mcp menu
/mcp menuConfigPatch operation types for Vibe Codeextra_headers field to ProviderConfigvibe.user_cancelled_action ACP telemetry coveragevibe.new_session telemetry event emitted whenever the session is resetmistral-medium-3.5Scratchpad directory for temporary working files shared with subagents
/copy slash command--trust session-only flag and fail-fast behavior in -p modeConfigLayer for layered configuration resolution~/.vibe/prompts overrides for builtin prompts/mcp menu/compactvibe.ready telemetry eventauto_approve config to bypass_tool_permissions--continue now only looks for sessions of the current working directoryMallocStackLogging error messages suppressed in CLI inputindex.lock leftover on interrupted deferred initfind commands allowed by default### Fixed - Fixed changelog and whats_new
Builtin skills system with self-awareness skill
cwd configuration parameter for MCP stdio servers/connectors as alias for /mcp and R refresh shortcut in MCP browserMergeFieldMetadata and annotated merge strategy helpers for config schemasvibe.request_sent telemetry event fired before each LLM API calltool_call_finished telemetry eventrequest_sent telemetry fields and added nb_prompt_chars/mcp menu by connection state then alphabetically/debug command no longer throws/terminal-setup commandMergeStrategy enum and merge logic for configuration
MergeStrategy enum and merge logic for configurationcall_source=vibe_code field in LLM request metadataapi.mistral.aiapi_base parsingDisplay detected files and LLM risks in trust folder dialog
read_safe for non-UTF-8 filesOne column per month.