Mistral Vibe native reference
Start with the Vibe setup.
Agents and skills
Agents
- Agents are written as
agent_type = "subagent"with inlineinstructions, a description, and an optionalactive_model. A subagent runs on that model only from v3.0.3. x-vibe.agent_type: agentkeeps a primary profile, selected withvibe --agent <name>.- Vibe 3.0.3 reserves the name
main(any case) for hook matching and does not load a file with that name. Sync stops and asks you to rename the agent. Import notes such a file. - Portable tools map
Bash,Read,Write,Edit,Greptobash,read_file,write_file,edit,grep. - Tools that cannot be mapped are omitted with a note, and the rest keep the agent restricted. If none can be mapped, sync fails.
- For Vibe-specific policy use
x-vibe.enabled_tools,x-vibe.disabled_tools, and nativex-vibe.toolspermission tables. - Empty
enabled_toolswould allow every tool, so sync rejects it. - Portable
readonlyand permission patterns have no mapping. Vibe'ssafetyfield controls presentation, not access.
Skills
- Skills keep
user-invocable,disable-model-invocation, and bundled files. - Skill descriptions accept 1 to 1,024 Unicode characters. Accented letters and other multi-byte characters count as one character each, matching the native metadata limit.
- Names: lowercase letters, digits, and single hyphens, up to 64 characters.
allowed-toolsis descriptive metadata. Vibe does not enforce it.
Connections, settings, and hooks
MCP servers
- Names keep their original spelling.
- Vibe compares case-sensitive identities: each character outside ASCII letters, digits,
_,-becomes_, edge underscores and hyphens are stripped, then the first 256 characters are kept. An empty or colliding identity stops sync and import. - Supported: stdio and streamable HTTP. SSE and WebSocket are omitted with a note.
- HTTP headers use native static authentication under
[mcp_servers.auth]. - For OAuth or environment-backed authentication use
x-vibe.auth, for exampletype: staticandapi_key_env: DOCS_TOKEN. Vibe reads that variable name at runtime. - Environment references in URLs, arguments, headers, and stdio environment values have no verified expansion and give coverage notes.
Settings
modelmaps toactive_model. Other native project settings pass throughx-vibe.- Portable reasoning effort and permission settings give coverage notes. Vibe's reasoning setting belongs to each model.
- User scope:
approvalsset toreviewfor Vibe writesdefault_agent = "smart-approve"to~/.vibe/config.toml. See review through the tool's own reviewer. - User scope: portable voice settings write
voice_mode_enabled. Vibe's experimental dictation has no mode or language key.
Hooks
- Vibe 3.1.1 supports
pre_tool,post_tool,pre_agent,post_agent,notification,session_start, andsession_end. - Vibe 3.1.3 adds
pre_llmbefore each model request andpost_llmafter each model response. matchermaps to nativematch. Nativematchvalues pass through. A shell guard should match bothbashandprocess_start.timeoutis in seconds.- Set
x-vibe.strict: trueonpre_tool,post_tool,pre_agent,pre_llm, orpost_llm. See the Vibe 3.1.3 hook schema. - On
post_agent,matchruns the hook only after the named agent ends its turn.match: mainselects the main agent (Vibe 3.0.3 and later). - Hooks get JSON on standard input and answer with Vibe JSON. Exit zero with
{"decision":"deny","reason":"..."}denies by event:pre_toolblocks the call,post_toolrewrites its output,post_agentrequests a retry. - A nonzero exit is a hook failure. Claude-style exit 2 and portable lifecycle events are not translated.
- Commands get
AGNOSTIC_AI_TARGET=vibe. Arguments fold into the command, because Vibe has no argument field. - Windows: arguments PowerShell cannot preserve cause an error. Write the full native command instead.
Import and ownership
Import
Run agnostic-ai import vibe before syncing handwritten project files.
- Reads: instructions, agent TOML, skill folders, MCP entries, model and native settings, hook TOML.
- Native fields stay under
x-vibe. That includes skillallowed-tools, kept as a scalar or list, with names such asread_fileandask_user_question. They stay descriptive metadata. - Literal credentials in native settings, profiles, and connection fields are refused. Keep credentials in user configuration or use a native environment-variable setting.
- An agent that points at a system prompt without inline instructions stops import. Copy the prompt into
instructionsfirst.
Ownership
- Global sync adopts equal handwritten entries without rewriting them.
- An omitted
sampling_enabledcompares asfalse, Vibe's native default. A handwrittentrueconflicts unless the spec setsx-vibe.sampling_enabled: true. - If an earlier sync adopted
sampling_enabled: truefrom a spec that omitted it, sync stops before changing the file. Setx-vibe.sampling_enabledtotrueto keep it orfalseto turn it off. - Sync changes and removes only its recorded MCP and hook entries. Other entries, comments, and file permissions stay.
- A hand-edited owned entry stops sync.
- An equivalent inline array can be adopted. Changes need native
[[mcp_servers]]or[[hooks]]tables. import --global vibekeeps unmanaged connections and hooks and skips entries still equal to managed state.- Source layout and commands: global configuration.