# Caravel

> Caravel is a local-first desktop workspace for multiple AI coding agents, for developers working across projects and tasks. It supports macOS (Apple Silicon / Intel) and Windows x64.

Caravel brings Claude Code, Codex, OpenCode, pi, Grok, TRAE, and Antigravity into one workbench. Users bring their own agents and model accounts. This website provides product information, downloads, and a browser demo using sample data; it does not expose a public agent execution API.

## Official website

- [English](https://caravel-site.pages.dev/en/): Product overview and FAQ in static HTML.
- [简体中文（默认）](https://caravel-site.pages.dev/): 中文产品介绍与常见问题，无需执行 JavaScript 即可读取。

## Product documentation

- [产品摘要 — 简体中文](https://caravel-site.pages.dev/index.md): 已实现能力、支持的 Agent、安装前提和产品边界。
- [Product summary — English](https://caravel-site.pages.dev/en/index.md): Capabilities, requirements, installation, and product boundaries in Markdown.
- [Feature guide — English](https://raw.githubusercontent.com/yy36295238/caravel-releases/main/docs/product-overview.en.md): Detailed product capabilities and typical workflows.
- [功能说明 — 简体中文](https://raw.githubusercontent.com/yy36295238/caravel-releases/main/docs/product-overview.md): 产品定位、功能与典型使用流程。

<!-- manual:start -->
## 使用手册（简体中文）

- [Caravel 使用手册](https://caravel-site.pages.dev/zh-CN/docs/): 一步一图，从下载安装到发出第一个任务、检查改动并验收，再到定时器、工作流、数据库等全部功能。
- [认识界面](https://caravel-site.pages.dev/zh-CN/docs/overview/): 打开 Caravel 后看到的主界面叫「工作台」。这一篇用一张图说明每块区域是做什么的，以及任务列表里各种状态的含义。
- [下载安装](https://caravel-site.pages.dev/zh-CN/docs/install/): 从官方下载页获取安装包，在 macOS 或 Windows 上完成安装和第一次打开。
- [安装并登录 Agent](https://caravel-site.pages.dev/zh-CN/docs/agent-setup/): Agent 是真正替你写代码的 AI 编程助手。在设置中安装至少一个 Agent，登录账号，再选好默认使用哪一个。
- [添加项目](https://caravel-site.pages.dev/zh-CN/docs/add-workspace/): 把电脑上的项目文件夹登记到 Caravel，它就成为一个「工作区」。Agent 只在你指定的工作区里干活。
- [发出第一个任务](https://caravel-site.pages.dev/zh-CN/docs/first-task/): 选一个项目，用一句话说清要做什么，交给 Agent。五步完成，Agent 会自己读代码、改代码，做完后通知你检查。
- [查看结果并验收](https://caravel-site.pages.dev/zh-CN/docs/review/): Agent 做完后，先看它说了什么，再看它具体改了哪些代码，最后决定采用、继续修改还是放弃。
- [继续对话与补充要求](https://caravel-site.pages.dev/zh-CN/docs/chat/): 任务发出后，可以随时在输入框里补充要求、附上图片和文件、引用其他任务或插入常用提示词，也可以中途停止。
- [同时管理多个任务](https://caravel-site.pages.dev/zh-CN/docs/views/): 任务多起来后，用搜索和筛选快速找到任务，用看板按状态查看全局，用分屏同时盯住几个正在运行的任务。
- [管理单个任务](https://caravel-site.pages.dev/zh-CN/docs/task-actions/): 在任务标题栏修改标题、收藏、加标签，关联相关任务和资料；「更多操作」菜单里可以新建或分叉会话、打开目录、归档和删除。
- [运行方式：隔离副本与独立分支](https://caravel-site.pages.dev/zh-CN/docs/run-modes/): 默认情况下 Agent 直接修改你的项目。开启隔离副本或独立分支后，Agent 在一份副本里工作，你验收满意后再合并或提交，原项目不受影响。
- [一个任务同时修改多个项目](https://caravel-site.pages.dev/zh-CN/docs/multi-project/): 需求同时涉及前端和后端、主项目和公共库时，可以给任务关联其他工作区，让 Agent 在一个任务里一起修改。
- [Git 操作：分支、提交与推送](https://caravel-site.pages.dev/zh-CN/docs/git/): 不用打开终端，在 Caravel 里查看改动、提交、推送、切换分支、查看历史和储藏改动。每个按钮旁都标注了对应的 Git 命令。
- [任务库：查找历史任务](https://caravel-site.pages.dev/zh-CN/docs/library/): 任务库以表格列出全部任务，可以按 Agent、状态、日期、标签筛选，收藏、归档或删除，适合回头查找以前做过的事。
- [会话台：随时开聊](https://caravel-site.pages.dev/zh-CN/docs/sessions/): 不想先选项目、写完整需求时，用会话台直接和 Agent 聊。适合梳理想法、整理计划或讨论技术问题。
- [定时器：到点自动执行](https://caravel-site.pages.dev/zh-CN/docs/schedules/): 让 Caravel 在指定时间自动提醒、运行脚本或派发 Agent 任务，例如每个工作日早上汇总昨天的代码提交。
- [工作流：把固定流程交给 Agent](https://caravel-site.pages.dev/zh-CN/docs/workflows/): 把「分析需求 → 实现 → 人工检查」这样反复使用的流程保存成模板，以后一键运行，Agent 按步骤推进，关键节点停下来等你确认。
- [提示词：保存常用说法](https://caravel-site.pages.dev/zh-CN/docs/prompts/): 把经常要对 Agent 说的话保存成提示词，下次在输入框输入 / 就能插入，不用每次重新打字。
- [待办板与收件箱](https://caravel-site.pages.dev/zh-CN/docs/todos/): 待办板记录要做的事，可以一键转成 Agent 任务；收件箱随手记下灵感和资料。配合全局快捷键，不打断手头工作就能记录。
- [编辑器：查看和修改文件](https://caravel-site.pages.dev/zh-CN/docs/editor/): 不用打开别的软件，在 Caravel 里浏览项目文件、做小修改、阅读 Markdown 文档或记临时草稿。
- [我的应用：一句话做个小工具](https://caravel-site.pages.dev/zh-CN/docs/apps/): 描述想要的小工具，Agent 自动生成一个能直接使用的小应用，例如喝水提醒、日报助手、JSON 工具箱。也可以把常用网页添加进来。
- [数据库：查询和修改数据](https://caravel-site.pages.dev/zh-CN/docs/database/): 连接 MySQL、PostgreSQL、SQLite、MongoDB 和 Redis，写 SQL 查询、浏览表数据，修改数据前会预览并确认，也可以让 AI 帮你写 SQL。
- [MongoDB 与 Redis](https://caravel-site.pages.dev/zh-CN/docs/database-nosql/): 浏览 MongoDB 集合和文档、按字段或命令查询、查看推断的字段结构；浏览 Redis Key，查看值和过期时间，执行只读命令。
- [洞察台：看用量和效率](https://caravel-site.pages.dev/zh-CN/docs/insights/): 统计各 Agent 和模型消耗了多少 Token、任务完成得快不快、哪些工具用得最多，帮你了解 AI 花在了哪里。
- [复盘台：让 AI 帮你写周报](https://caravel-site.pages.dev/zh-CN/docs/recap/): 选择一段时间，让 Agent 阅读这期间的任务和对话，总结成果、问题和改进建议，生成可以直接用于周报的复盘报告。
- [设置：外观、终端与更新](https://caravel-site.pages.dev/zh-CN/docs/settings/): 调整界面语言、配色主题和缩放比例，决定左侧菜单显示哪些功能，选择默认终端，检查更新和查看服务日志。
- [技能、MCP 与插件](https://caravel-site.pages.dev/zh-CN/docs/skills/): 统一管理各 Agent 的技能（Skill）、MCP 服务和插件，按 Agent 分别开关，新建任务时按需选用。
- [网页与手机访问](https://caravel-site.pages.dev/zh-CN/docs/web-access/): 在本机浏览器里使用完整工作台，或用同一局域网内的手机查看和处理任务。
- [飞书远程控制](https://caravel-site.pages.dev/zh-CN/docs/remote/): 通过飞书接收任务通知，派发任务、批准操作和验收，也可以用自然语言发指令。
- [常见问题](https://caravel-site.pages.dev/zh-CN/docs/faq/): 安装、费用、任务运行、数据和远程使用中最常遇到的问题，以及常用快捷键。
- [名词解释](https://caravel-site.pages.dev/zh-CN/docs/glossary/): 手册中出现的专业名词，用大白话解释。
<!-- manual:end -->

## Downloads and demo

- [Latest release](https://github.com/yy36295238/caravel-releases/releases/latest): Official installers and release notes; use this page for the current version.
- [Installation help](https://caravel-site.pages.dev/en/#install-help): Platform-specific installation and first-launch instructions.
- [Interactive demo](https://caravel-site.pages.dev/demo/?lang=en): Actual product interface with simulated data and actions; requires JavaScript.