intent-hq/intent

Monorepo for the Intent platform — tracks intentd, cloudlands-fe, and ios as submodules; docs, CI, and release orchestration

Intent – 概览

Intent 是一款专为使用 AI 编码代理的开发者所设计的桌面生产力平台。它内置了一个基于 Rust 的后端守护进程 (intentd)，将所有状态（工作区、笔记、任务、git 仓库、终端以及代理本身）存储在本地的 SQLite 数据库中，并通过 Unix-domain socket（供桌面客户端使用）或安全 WebSocket（供远程客户端如 iOS 配套应用使用）公开 JSON-RPC 2.0 API。

核心功能

统一工作区 – 从单一 UI 管理代码、笔记、任务和终端会话。
编码代理 – 可插件化的 AI 代码助手（Claude Code, Codex 等），作为外部进程运行，但由守护进程进行协调。
Git 集成 – 基本的 git 操作由守护进程处理并呈现在 UI 中。
本地优先与隐私优先 – 所有数据保留在机器上；不发送任何遥测数据。网络流量仅限于可选的自动更新和用户发起的提供商登录。
跨平台客户端 – Electron + SvelteKit 桌面应用（macOS, Linux, Windows）以及 SwiftUI iOS 配套应用（目前为私有）。

架构

Desktop app (Electron + SvelteKit)   <-- JSON‑RPC -->   intentd (Rust daemon)
        |                                            |
        └─ iOS app (SwiftUI) –‑ JSON‑RPC over WSS/TLS ──┘

守护进程持有权威状态并运行代理运行时。
客户端为轻量级；它们仅负责渲染 UI 并将用户操作转发给守护进程。
持久化使用 SQLite；通信使用 JSON-RPC 2.0。

安装与部署

普通用户：从 [intentapp.dev] 下载打包好的应用程序；该应用内置了 intentd。
高级 / 远程用户：单独安装 intentd 守护进程（通过单行脚本、Homebrew 或 .deb 包）。守护进程包含一个自动更新的“sitter”，可从公开发布仓库获取最新的二进制文件。
开发：使用子模块克隆仓库，并使用提供的 make 目标（make dev, make dev-prod, make dev-daemon）。构建需求为 Rust, Cargo 以及可选的覆盖率工具。

可扩展性与生态系统

代理提供商 – 守护进程可以通过 CLI/OAuth 流程连接到多个 AI 编码代理服务（Claude, Codex 等）。
集成 – 可选连接到 GitHub, Linear, Sentry 以及用户定义的 MCP 服务器。
远程使用 – 守护进程可以公开一个安全 WebSocket 端点，允许其他设备（例如 iOS 应用）配对并使用相同的工作区。

社区与治理

该仓库目前为 只读快照；在项目准备好公开发布期间，暂停外部贡献。
通过 GitHub issue 表单接受问题；安全报告应私下发送。
采用 Apache 2.0 授权。

总结：Intent 是一款真正的开源工具，用于协调 AI 编码代理及相关开发工作流程产物，并在轻量级 UI 与处理状态、代理执行及安全远程访问的 Rust 后端之间实现了清晰的分离。