CALENDAR WITH YOUR FRIENDS · README
Cobuild
v0.1.0
What it does, how to install it, how to use it, and where your data lives — the whole manual on one page.
它是什么、怎么装、怎么用、数据在哪——整本手册就在这一页。
Why Cobuild为什么是 Cobuild
Most calendars hide the work. Cobuild is a task library with a calendar view: tasks are the data, the calendar is how you look at them.
It is built for two or three people sharing one workspace, running on your own machine — and it shows you which tasks an agent wrote, which are yours, and which came from a colleague.
大多数日历把工作藏起来了。Cobuild 是「任务库 + 日历视图」：任务是数据，日历只是看它的方式。
它给两三个人共用一个工作区、跑在你自己的机器上——而且会标出哪条任务是 agent 写的、哪条是你的、哪条是同事的。
What it does能做什么
- Calendar first: opens on today, not on a project list.
- Tasks with assignee, project, recurrence; single occurrences can be edited as this-one or all-future.
- Shared workspace mounted from a folder on disk; open files in your own editor, versions are kept.
- Agent access over MCP: agents read your tasks and free time, and plan changes wait for your confirmation.
- Export or share a read-only calendar link; recipients need nothing installed.
- 日历优先：打开就是今天，不是项目列表。
- 任务带指派人、项目、重复；单次修改可选「仅这一次 / 之后全部」。
- 共享工作区挂在硬盘上的文件夹；用你自己的编辑器打开文件，版本自动留。
- agent 通过 MCP 接入：能读任务与空闲时间，排的计划要你确认才进日历。
- 可导出或发只读日历链接，对方不用装任何东西。
Install安装
Windows build (0.1.0 beta). Install, launch — the local service starts with the app on 127.0.0.1 only. Nothing listens on the network until you deliberately put it behind Tailscale or a tunnel.
Windows 版（0.1.0 内测）。装完打开，本地服务随应用启动，只听 127.0.0.1。你不主动挂到 Tailscale 或隧道上，它不会对外监听。
How to use使用说明
- First launch: create the admin account.
- Mount a folder as the shared workspace.
- Drag a slot on the calendar or press new task; assign it to someone — that is how work gets handed over.
- Invite the other one or two people with an invite code.
- Give an agent a token if you want it to read your schedule or draft plans.
- 首次启动：建管理员账号。
- 挂一个文件夹作为共享工作区。
- 在日历上拖一段时间，或点新建任务，指派给某人——指派就是「布置了工作」。
- 用邀请码把另外一两个人拉进来。
- 想让它读你的日程或起草计划，就给 agent 一个 token。
Data, privacy, limits数据、隐私、限制
Everything — tasks, files, versions, tokens — lives in a local SQLite database and a data folder you choose. Nothing is uploaded to us.
Known limits: TLS is not implemented, so a non-loopback listener refuses to start; v1 does not attempt real-time collaboration or end-to-end encryption; 2–3 people per workspace is the design target.
任务、文件、版本、token 全部落在本地 SQLite 与你选定的数据目录里，不会上传到我们这边。
已知限制：TLS 未实现，所以非回环监听会直接拒绝启动；v1 不做实时协同与端到端加密；每个工作区 2–3 人是设计目标。
Version, update, tech版本、更新、实现
Version 0.1.0 beta. The desktop app has a check-for-updates button under About; it never checks silently at startup.
Rust + axum service, SQLite with WAL, React front end shared by desktop and browser, seventeen MCP tools for agents.
版本 0.1.0 内测。桌面端「关于」里有检查更新按钮，不做启动静默检查。
技术：Rust + axum 服务、SQLite（WAL）、React 前端（桌面与浏览器共用），给 agent 的 MCP 工具共十七个。