Whereabot

Whereabot

让你的 AI Agent 按需询问你的手机你在哪里。中继服务由你托管。登录信息和用户数据存储在 Supabase 中。

flowchart LR
  Agent["AI agent"] -->|"MCP or HTTP"| Relay["Relay (Rust)"]
  Relay -->|WebSocket| Phone["Phone app (Tauri)"]
  Phone -->|"GPS fix"| Relay
  Relay -->|"answer"| Agent

中继服务不会保留位置历史记录。它发送一次 ping，手机读取此刻的 GPS 位置，然后将答案返回给 Agent。存储哪些信息、保留多久，以及谁能看到你的位置：隐私。

状态

早期 MVP，处于 beta 阶段。iOS 可通过推送在后台响应。Android 仅在应用打开时响应。请参阅路线图。

仓库布局

路径	内容
server/	Rust 中继服务（axum）。Agent 通过 HTTP 或 MCP 调用它；手机通过 WebSocket 与其保持连接。
app/	Tauri v2 手机应用（Android / iOS）。登录后，通过 GPS 定位响应 ping。
supabase/	数据库迁移和测试。
infra/	用于开发和生产环境的 OpenTofu 配置。
scripts/	本地开发、端到端检查、部署、钩子安装。
docs/	文档网站的源文件。
site/	落地页和 OAuth 同意页面。
docs-site/	文档网站的 VitePress 构建。
design-system/、brand/	共享 CSS 令牌和组件；徽标文件及使用规则。

连接你的 Agent

1. 安装应用：参阅 在 whereabot.io 上开始使用，或从浏览器安装。

2. 在手机上使用 Google 登录。

3. 将中继服务添加到你的 Agent：

   claude mcp add --transport http whereabot https://relay.whereabot.io/mcp
   

4. 在 Claude Code 中运行 /mcp，并使用手机上相同的 Google 账号登录。你无需粘贴令牌。

5. 在 Android 上，Agent 发起询问期间，请保持应用打开，直到 Android 推送功能上线。

中继服务 URL：线上 URL。工具及其参数：协议。

自托管

使用 infra/ 中的 OpenTofu 配置运行自己的中继服务和 Supabase 项目。步骤：infra/README.md。使用你的 Supabase 和中继服务配置构建应用（app/.env.example），然后将中继服务添加到你的 Agent。若要先在一台电脑上运行所有服务：本地快速入门。

文档

所有文档（包括生成的 MCP 和线路协议参考）：whereabot.io/docs。本仓库中的文档：

• 架构：组件、登录和 ping 流程、安全性、限制
• 协议：意图层面的 HTTP、MCP 和 WebSocket
• 请求流程：单次请求的每个状态、通知和 Agent 结果
• 位置共享：允许他人的 Agent 询问你的位置
• 隐私：存储哪些信息、保留期限、谁能看到你的位置
• 运维和基础设施：运行、部署和发布方式
• 先前方案和路线图
• 上架：MCP 目录、server.json、发布方式

社区

• 贡献指南：本地设置、钩子、规则、添加迁移
• 安全策略：私下报告漏洞
• 行为准则

许可证

MIT。第三方材料：THIRD_PARTY_NOTICES.md。