Mistral Vibe 使用手册：云端异步 Agent，启动任务就去忙别的

# 方式 A：pip 安装（推荐）
pip install mistral-vibe

# 方式 B：从源码安装
git clone https://github.com/mistralai/mistral-vibe.git
cd mistral-vibe
pip install -e .

# 验证安装
vibe --version

1. 访问 Mistral Console
2. 注册账号并创建 API Key
3. 配置 Key：

# 设置 API Key
export MISTRAL_API_KEY="your-api-key"

# 或写入配置文件
vibe config set apiKey "your-api-key"

# 选择默认模型（推荐 Medium 3.5）
vibe config set model "mistral-medium-3.5"

# 进入项目目录
cd my-project

# 启动 Vibe
vibe

# 直接提问
> 帮我重构 src/utils/helpers.ts，把重复代码提取成公共函数

# 指定文件上下文
> @src/auth/login.ts 这个函数的错误处理不完善，帮我改进

常用操作：

• @文件路径 — 引用特定文件作为上下文
• /plan — 先让 AI 分析方案再执行
• /diff — 查看代码变更预览
• /commit — AI 生成 commit message 并提交
• Ctrl+C — 中断
• Ctrl+D — 退出

这是 Mistral Vibe 最独特的功能：

1. 在本地 CLI 中描述你的任务
2. 按 Ctrl+R 或输入 /remote 将任务发送到云端
3. 云端在隔离沙箱中独立执行，不占用本地资源
4. 完成后自动开 PR 并通知你

# 示例：委派一个重构任务到云端
> /remote
帮我把这个项目从 JavaScript 迁移到 TypeScript：
1. 为所有 .js 文件创建对应的 .ts 版本
2. 添加类型定义
3. 修复所有类型错误
4. 更新 tsconfig.json

# Vibe 输出：
# 🌀 Remote Agent started (ID: ra-abc123)
# 📊 Track: https://console.mistral.ai/agents/ra-abc123
# 🔔 You'll be notified when it completes

同时运行多个 Remote Agent：

# 终端 1：云端迁移 TypeScript
vibe /remote "将项目从 JS 迁移到 TS"

# 终端 2：云端补充测试
vibe /remote "为所有 API 端点补充集成测试"

# 终端 3：本地修 Bug
vibe
> 修复用户登录后 session 丢失的问题

如果你在本地做任务做到一半发现太耗时间，可以一键传到云端继续：

# 在本地对话中
> 这个重构任务涉及的文件太多了，帮我转到云端执行

# 使用 Teleport
/teleport

# Vibe 输出：
# 🚀 Session teleported to cloud (ID: ra-xyz789)
# 💾 Full context preserved
# 🔔 You'll be notified when it completes

Teleport 会保留完整的对话上下文，云端 Agent 从你停下的地方继续。

# 配置 GitHub 集成
vibe integrate github --token "ghp_xxx"

# 配置 Jira 集成
vibe integrate jira --url "https://your-org.atlassian.net" --token "xxx"

# 配置 Slack 通知
vibe integrate slack --webhook "https://hooks.slack.com/xxx"

# 配置 Sentry 错误追踪
vibe integrate sentry --dsn "https://xxx@sentry.io/xxx"

集成后，Remote Agent 可以自动关联 Jira 任务、在完成后发 Slack 通知、从 Sentry 获取错误上下文。

Mistral 的 Le Chat 新增了 Work Mode，适合非编码的复杂任务：

• 📝 撰写技术方案文档
• 📊 数据分析报告生成
• 🔍 代码审查和架构评估
• 📋 项目规划和任务拆解

# 在 Le Chat 中切换到 Work Mode
# 访问 https://chat.mistral.ai
# 点击左下角 "Work Mode" 开关