# RooQi

> RooQi is a note-taking app for iPhone, iPad and Mac that brings handwriting, typed notes, PDFs and recordings together, with optional AI (RooQi AI subscription) for asking about notes and generating minutes from recordings. Status (2026-10-26): in testing; not yet available on the App Store. RooQi Keyboard is a separate iPhone keyboard app.

Facts on this site are limited to verified, public product information. Each document states platforms, version, status and last-verified date. Developer features (MCP server and CLI bridge) are a Mac-only preview. Contact: hello@rooqi.ai.

## User guide (English)
- [Quick start](https://rooqi.cn/docs/guide/quick-start.md): Install RooQi, finish the welcome steps and create your first note. — Platforms: iPhone, iPad, Mac; Version: RooQi 1.0 (pre-release); Status: Pre-release — RooQi is in testing and not yet on the App Store; Verified: 2026-10-26 against the 1.0 test build interface; Limitations: Public download is not available yet. Menu names may change before release.
- [Notes, handwriting and canvases](https://rooqi.cn/docs/guide/notes-and-handwriting.md): Write by hand and type on the same page, use canvases, convert handwriting and build mind maps. — Platforms: iPhone, iPad, Mac; Version: RooQi 1.0 (pre-release); Status: Pre-release; Verified: 2026-10-26 against the 1.0 test build interface; Limitations: Handwriting tools are richest on iPad. Handwriting conversion quality depends on your writing and the language.
- [Recording and transcription](https://rooqi.cn/docs/guide/recording-and-transcription.md): Record lectures and meetings, transcribe on your device, and optionally improve transcripts in the cloud. — Platforms: iPhone, iPad, Mac; Version: RooQi 1.0 (pre-release); Status: Pre-release; Verified: 2026-10-26 against the 1.0 test build interface and the RooQi privacy policy (2026-10-24); Limitations: On-device transcription depends on the speech models available for your device and language. Automatic speaker separation currently distinguishes up to 4 speakers.
- [PDFs and files](https://rooqi.cn/docs/guide/pdfs-and-files.md): Import PDFs and images, highlight and annotate, and export with your annotations. — Platforms: iPhone, iPad, Mac; Version: RooQi 1.0 (pre-release); Status: Pre-release; Verified: 2026-10-26 against the 1.0 test build interface; Limitations: Very large PDFs may take longer to prepare after import.
- [Ask RooQi AI and make minutes](https://rooqi.cn/docs/guide/ai-and-minutes.md): Ask questions about notes, pages and recordings, and turn a recording into minutes. — Platforms: iPhone, iPad, Mac; Version: RooQi 1.0 (pre-release); Status: Pre-release · requires the optional RooQi AI subscription; Verified: 2026-10-26 against the 1.0 test build interface, the support page and the privacy policy (2026-10-24); Limitations: AI answers can be wrong — check the sources. Subscription prices are shown only on the App Store.
- [Sync, export and backup](https://rooqi.cn/docs/guide/sync-and-backup.md): Keep your library in sync with iCloud, and export or back up your work. — Platforms: iPhone, iPad, Mac; Version: RooQi 1.0 (pre-release); Status: Pre-release; Verified: 2026-10-26 against the 1.0 test build interface and the privacy policy (2026-10-24); Limitations: iCloud sync needs an Apple Account, network access and iCloud storage. RooQi does not describe the iCloud private database as end-to-end encrypted by RooQi.
- ["Tutorials: lectures, meetings and reading"](https://rooqi.cn/docs/guide/tasks.md): Three end-to-end workflows that combine recording, handwriting, PDFs and AI. — Platforms: iPhone, iPad, Mac; Version: RooQi 1.0 (pre-release); Status: Pre-release; Verified: 2026-10-26 against the 1.0 test build interface; Limitations: Steps marked “subscription” need RooQi AI. Always check AI output against the original.
- [Frequently asked questions](https://rooqi.cn/docs/guide/faq.md): Answers about accounts, privacy, recordings, sync and subscriptions. — Platforms: iPhone, iPad, Mac; Version: RooQi 1.0 (pre-release); Status: Pre-release; Verified: 2026-10-26 against the RooQi support page and privacy policy (2026-10-24)

## Developers (English)
- [Developer overview](https://rooqi.cn/docs/developers/overview.md): What the RooQi MCP server and command-line bridge can do, where they run and what they can’t do. — Platforms: Mac only (macOS 14 or later); Version: RooQi for Mac 1.0 test build · bridge protocol v1 · MCP server “RooQi” 0.1.0; Status: Preview — included in Mac test builds; not yet publicly released; Verified: 2026-10-26 against the RooQi Mac source (RooQiBridge/Main.swift, RooQiIPCShared/Wire.swift, ExternalConnection.swift); Limitations: Mac only — iPhone and iPad have no external connection. There is no public HTTP/REST API. Names and limits may change before release.
- [Install, connect and authorize](https://rooqi.cn/docs/developers/connect.md): Enable External Connections in RooQi for Mac, configure an MCP client, and approve access. — Platforms: Mac only (macOS 14 or later); Version: RooQi for Mac 1.0 test build · bridge protocol v1; Status: Preview — not yet publicly released; Verified: 2026-10-26 against the RooQi Mac source and its English UI strings; Limitations: The bridge lives inside RooQi.app; its path changes if you move the app. After updating RooQi, close and re-enable the connection. Client configuration examples are not yet tested against every MCP client.
- [MCP tool reference](https://rooqi.cn/docs/developers/mcp-reference.md): Every tool the RooQi MCP server exposes, with exact input schemas, results and errors. — Platforms: Mac only (macOS 14 or later); Version: MCP server “RooQi” 0.1.0 · bridge protocol v1 · MCP Swift SDK 0.12.1; Status: Preview — not yet publicly released; Verified: 2026-10-26 against Apps/RooQiMac/IPC/Sources/RooQiBridge/Main.swift and RooQiIPCShared/Wire.swift; Limitations: All tools reject unknown or missing fields with malformedRequest. Requests and responses are limited to 16,384 bytes. At most 8 calls can be in flight per connection; each times out after 8 seconds.
- [CLI reference](https://rooqi.cn/docs/developers/cli-reference.md): The rooqi command — status, list, read, run and pdf — with input formats and exit codes. — Platforms: Mac only (macOS 14 or later); Version: RooQi for Mac 1.0 test build · bridge protocol v1; Status: Preview — not yet publicly released; Verified: 2026-10-26 against Apps/RooQiMac/IPC/Sources/RooQiBridge/Main.swift; Limitations: Each CLI process is a new connection and needs its own approval. Batch input is limited to 16 requests and 262,144 bytes.
- [Responses and errors](https://rooqi.cn/docs/developers/errors.md): The response envelope and every response code returned by the RooQi bridge. — Platforms: Mac only (macOS 14 or later); Version: Bridge protocol v1; Status: Preview — not yet publicly released; Verified: 2026-10-26 against RooQiIPCShared/Wire.swift and Client.swift
- [Examples and workflows](https://rooqi.cn/docs/developers/examples.md): End-to-end flows for reading notes, appending text safely and annotating a PDF. — Platforms: Mac only (macOS 14 or later); Version: MCP server “RooQi” 0.1.0 · bridge protocol v1; Status: Preview — not yet publicly released; Verified: 2026-10-26 against the RooQi Mac source; flows not yet re-run on a public release; Limitations: Try new workflows on a separate test project first.

## 简体中文文档
- [快速开始](https://rooqi.cn/zh-hans/docs/guide/quick-start.md): 安装 RooQi，完成欢迎设置，创建第一份笔记。 — Platforms: iPhone、iPad、Mac; Version: RooQi 1.0（预发布）; Status: 预发布——RooQi 正在测试，尚未登陆 App Store; Verified: 2026-10-26，依据 1.0 测试版本界面; Limitations: 暂无公开下载。正式发布前菜单名称可能调整。
- [笔记、手写与画布](https://rooqi.cn/zh-hans/docs/guide/notes-and-handwriting.md): 在同一页手写和打字，使用画布、识别手写、绘制导图。 — Platforms: iPhone、iPad、Mac; Version: RooQi 1.0（预发布）; Status: 预发布; Verified: 2026-10-26，依据 1.0 测试版本界面; Limitations: 手写工具在 iPad 上最完整。手写识别效果取决于书写与语言。
- [录音与转写](https://rooqi.cn/zh-hans/docs/guide/recording-and-transcription.md): 录下课堂与会议，在本机转写，并可选择在云端优化逐字稿。 — Platforms: iPhone、iPad、Mac; Version: RooQi 1.0（预发布）; Status: 预发布; Verified: 2026-10-26，依据 1.0 测试版本界面与 RooQi 隐私政策（2026-10-24）; Limitations: 本机转写取决于设备与语言可用的语音模型。自动区分说话人目前最多 4 位。
- [PDF 与文件](https://rooqi.cn/zh-hans/docs/guide/pdfs-and-files.md): 导入 PDF 与图片，高亮与批注，并带批注导出。 — Platforms: iPhone、iPad、Mac; Version: RooQi 1.0（预发布）; Status: 预发布; Verified: 2026-10-26，依据 1.0 测试版本界面; Limitations: 很大的 PDF 导入后可能需要更长的准备时间。
- [向 RooQi AI 提问与生成纪要](https://rooqi.cn/zh-hans/docs/guide/ai-and-minutes.md): 针对笔记、页面与录音提问，并把录音整理成纪要。 — Platforms: iPhone、iPad、Mac; Version: RooQi 1.0（预发布）; Status: 预发布 · 需要可选的 RooQi AI 订阅; Verified: 2026-10-26，依据 1.0 测试版本界面、支持页与隐私政策（2026-10-24）; Limitations: AI 回答可能出错，请核对来源。订阅价格仅以 App Store 页面为准。
- [同步、导出与备份](https://rooqi.cn/zh-hans/docs/guide/sync-and-backup.md): 用 iCloud 保持资料库一致，并导出或备份你的内容。 — Platforms: iPhone、iPad、Mac; Version: RooQi 1.0（预发布）; Status: 预发布; Verified: 2026-10-26，依据 1.0 测试版本界面与隐私政策（2026-10-24）; Limitations: iCloud 同步需要 Apple 账户、网络与 iCloud 储存空间。RooQi 不把 iCloud 私有数据库描述为由 RooQi 提供的端到端加密。
- [教程：课堂、会议与阅读](https://rooqi.cn/zh-hans/docs/guide/tasks.md): 结合录音、手写、PDF 与 AI 的三个完整流程。 — Platforms: iPhone、iPad、Mac; Version: RooQi 1.0（预发布）; Status: 预发布; Verified: 2026-10-26，依据 1.0 测试版本界面; Limitations: 标注“订阅”的步骤需要 RooQi AI。请始终对照原文核对 AI 结果。
- [常见问题](https://rooqi.cn/zh-hans/docs/guide/faq.md): 关于账号、隐私、录音、同步与订阅的解答。 — Platforms: iPhone、iPad、Mac; Version: RooQi 1.0（预发布）; Status: 预发布; Verified: 2026-10-26，依据 RooQi 使用支持页与隐私政策（2026-10-24）
- [开发者概览](https://rooqi.cn/zh-hans/docs/developers/overview.md): RooQi MCP 服务与命令行桥接能做什么、在哪里运行、不能做什么。 — Platforms: 仅 Mac（macOS 14 或更高版本）; Version: RooQi Mac 1.0 测试版本 · 桥接协议 v1 · MCP 服务“RooQi” 0.1.0; Status: 预览——包含在 Mac 测试版本中，尚未公开发布; Verified: 2026-10-26，依据 RooQi Mac 源码（RooQiBridge/Main.swift、RooQiIPCShared/Wire.swift、ExternalConnection.swift）; Limitations: 仅限 Mac，iPhone 与 iPad 没有外部连接。没有公开的 HTTP/REST API。正式发布前名称与限制可能调整。
- [安装、连接与授权](https://rooqi.cn/zh-hans/docs/developers/connect.md): 在 RooQi Mac 版中启用外部连接、配置 MCP 客户端并批准访问。 — Platforms: 仅 Mac（macOS 14 或更高版本）; Version: RooQi Mac 1.0 测试版本 · 桥接协议 v1; Status: 预览——尚未公开发布; Verified: 2026-10-26，依据 RooQi Mac 源码及其界面文案; Limitations: 桥接程序位于 RooQi.app 内，移动 App 后路径会变。更新 RooQi 后请关闭并重新启用连接。客户端配置示例尚未逐一在所有 MCP 客户端上测试。
- [MCP 工具参考](https://rooqi.cn/zh-hans/docs/developers/mcp-reference.md): RooQi MCP 服务提供的全部工具，含准确的输入 schema、结果与错误。 — Platforms: 仅 Mac（macOS 14 或更高版本）; Version: MCP 服务“RooQi” 0.1.0 · 桥接协议 v1 · MCP Swift SDK 0.12.1; Status: 预览——尚未公开发布; Verified: 2026-10-26，依据 Apps/RooQiMac/IPC/Sources/RooQiBridge/Main.swift 与 RooQiIPCShared/Wire.swift; Limitations: 缺少或多出字段一律返回 malformedRequest。请求与响应上限 16,384 字节。每个连接最多同时 8 个调用，单次 8 秒超时。
- [CLI 参考](https://rooqi.cn/zh-hans/docs/developers/cli-reference.md): rooqi 命令——status、list、read、run 与 pdf——的输入格式与退出码。 — Platforms: 仅 Mac（macOS 14 或更高版本）; Version: RooQi Mac 1.0 测试版本 · 桥接协议 v1; Status: 预览——尚未公开发布; Verified: 2026-10-26，依据 Apps/RooQiMac/IPC/Sources/RooQiBridge/Main.swift; Limitations: 每个 CLI 进程都是一次新连接，需要单独批准。批量输入最多 16 个请求、262,144 字节。
- [响应与错误](https://rooqi.cn/zh-hans/docs/developers/errors.md): RooQi 桥接返回的响应信封与全部响应代码。 — Platforms: 仅 Mac（macOS 14 或更高版本）; Version: 桥接协议 v1; Status: 预览——尚未公开发布; Verified: 2026-10-26，依据 RooQiIPCShared/Wire.swift 与 Client.swift
- [示例与工作流](https://rooqi.cn/zh-hans/docs/developers/examples.md): 读取笔记、安全追加文字与批注 PDF 的完整流程。 — Platforms: 仅 Mac（macOS 14 或更高版本）; Version: MCP 服务“RooQi” 0.1.0 · 桥接协议 v1; Status: 预览——尚未公开发布; Verified: 2026-10-26，依据 RooQi Mac 源码；尚未在公开发布版本上重新运行; Limitations: 新流程请先在单独的测试项目中尝试。

## Policies and support
- [RooQi App privacy policy](https://rooqi.cn/app/privacy/): Chinese (#zh) and English (#en).
- [RooQi App support](https://rooqi.cn/app/support/): subscriptions, devices, FAQ.
- [RooQi Keyboard privacy policy](https://rooqi.cn/keyboard/privacy/)
- [RooQi Keyboard support](https://rooqi.cn/keyboard/support/)

## Optional
- [Document manifest (JSON)](https://rooqi.cn/docs/index.json): ids, languages, platforms, versions, status, verification dates and content hashes.
- [Full text of all English docs](https://rooqi.cn/llms-full.txt)