life-distributable README

项目的 README,来自 github.com/mattabate/life-distributable。合并为一个 markdown 文件:README.md。

life logo: the app icon, an L made of a mint bar and a sand bar on dark green, next to the word life

life

A self-hosted swarm of AI agents, with apps on iPhone, Mac and web.

life is a self-hosted team of AI agents built on Claude Code. It will help you meet your goals, whatever they are.

Your Mac runs the agents. It connects to your iPhone over a private Tailscale VPN, and you talk to the agents from an iPhone app, a desktop app or a web app. Nothing is on the public internet. Only your devices can reach it, and you can connect as many as you like: a Mac mini, a laptop, a phone.

The agents learn about you and your goals as you work with them. They maintain their own code, and can change the UI or add data sources when asked. Dangerous actions, like sending emails, are safe behind a secure approval step.

Setup takes about 2 hours, mostly waiting on Apple and the Xcode download. You need a Mac that stays on, a Claude subscription (about $20 to $200 a month), and an Apple Developer membership ($99 a year, only for the iPhone and desktop apps).

Note: everything below is a starting point and subject to change. The agents maintain their own code, so they can change the app's front end or back end in whichever way suits you.

Install with one prompt

Open Claude Code on your Mac and paste this:

Clone github.com/mattabate/life-distributable and set up my life agent. Follow its SETUP.md.

The agent walks you through setup from there.

Use it at your own risk. life is free, open source software, provided as is with no warranty (see the LICENSE). The agents act for you, so they can spend money, send messages, delete files and share data. The approval step is there to catch that, and keeping it on is up to you. You are responsible for what your copy does, and nothing it tells you is legal, financial or medical advice.

⭐ Star it to get developer addenda: new features and fixes land in ADDENDA.md every week, and your agent brings each one to you.

The life desktop app's Sessions list: under Your turn, one row per agent with its open card: Charlotte, marketing manager, a build thread to post on X; Diane, executive assistant, dinner with friends on Friday or Saturday; Jules, head of AI, a local model that can route messages; Grace, chief technology officer, passing on work Tim finished; Fred, chief financial officer, two subscriptions for the same thing; Rachel, head of wellness, a sleep log. Under Working, Randy, whose chat is open on the right with a photo backup running and its progress bar. Under Idle, Herbert, chief of staff, and the rest of the team The life desktop app's Configuration page: Powered by Claude Code with how much of the 7 day limits is left; Devices, the Mac hub and a phone; the Team org chart under you: Herbert, chief of staff, Rachel, head of wellness, and Fred, chief financial officer; then Grace, chief technology officer, over Randy, Owen and Tim, Jules, head of AI, over Brahms the composer and Lothar the mathematician, and Diane, executive assistant, over Choppy the wedding planner; then Charlotte, marketing manager, and Justin, head of strategy; each card marked with the goals it owns; seven goals in Work, Social and Lifestyle; and the data sources for each goal with their logos
Sessions. Agents tell you when they need you. Configuration. Your team, goals, devices, and data.

Your first five minutes

You don't need to be technical.

  1. If you don't have Claude Code yet, install it with Anthropic's guide.
  2. Open Terminal: press Cmd-Space, type Terminal, press Return.
  3. In Terminal, type claude and press Return. Sign in with your Claude account if it asks.
  4. Give Claude the following prompt and press Return:
    Clone github.com/mattabate/life-distributable and set up my life agent. Follow its SETUP.md.
    
  5. Follow the instructions the agent gives you. It will ask what features you want at the start.

What people use it for

How it works

All of this is a starting point and subject to change. The agents maintain their own code, so if you don't like how something looks or works, just ask and they can change it from one prompt.

Example app layout

Desktop app

Calendar. Your steps and the agents' runs. Roles. Agents hand work to each other.
The life desktop app's Calendar on the week of November 8: a morning routine every day, piano harmony homework in the evening, a proof to read, plants to water, a build thread to post, lunch with a friend, a demo to record, the weekly team review, the app update Grace ships on Monday, her release notes to read on Tuesday, the music service to pick and gym days, with overdue, due, do soon and sessions waiting lists Grace, the chief technology officer, in the life desktop app, speaking aloud: a card telling you Tim, one of her engineers, finished the bigger calendar text and it is in tomorrow's update, with the 5 PM app update coming up below
Cards. The agent proposes, you approve. Cards. A running job shows its progress.
Charlotte, the marketing manager, in the life desktop app: an approval card to post this week's build thread on X, with the first post quoted, tagged share, with Approve, Deny, Reply and Dismiss, a rec she filed, and a search rankings check coming up below The life desktop app's Sessions list with Randy's chat open: an approved backup of 4,210 photos to cloud storage, running, its progress bar past halfway

iPhone app

An approval. In your pocket. Sessions. Cards waiting on you. Calendar. Your day at a glance.
The life iPhone app: Charlotte, the marketing manager, in chat with an approval card to post this week's build thread on X, the first post quoted, tagged share, with Approve, Deny, Reply and Dismiss buttons, a rec she filed, and a search rankings check coming up The life iPhone app Sessions tab: Your turn, 6 cards in 6 sessions, one row per agent: Charlotte's build thread to approve, Diane's dinner night to decide, Jules's local model to read, Grace speaking Tim's finished work aloud, and Fred's two subscriptions below The life iPhone app Calendar tab on November 8: the passport to renew, overdue, then seven items due today: the morning routine, plants to water at 9, the build thread to post at 11, lunch with a friend at 12:30, the demo to record at 3, a piano harmony exercise at 7 and lights out at 11

The screenshots are the real apps on a demo hub with made-up people and plans.

What it costs

Every cost below goes to an outside service. Nothing goes to me.

What Necessary? Cost Needed for
Claude Pro or Max Required $20, $100 or $200 a month Everything. Max is better for an always-on agent
A Mac on macOS 15 or later Required the one you own The hub
Tailscale Required free Reaching your hub privately from your phone and laptops
Apple Developer Program Optional $99 a year Only the iPhone app and the desktop app. Web only? Skip it
Backblaze B2 Recommended cents a month Nightly encrypted backup

Setup, in order

The agent follows SETUP.md. Here is the timeline.

  1. Pick your apps, see the costs (2 min). iPhone, desktop, web, or all three. Later changes are built for the ones you picked.
  2. Start the slow things (10 min, then waiting). Apple developer enrollment and the Xcode download start first. Apple usually answers within hours.
  3. Prepare the Mac (10 min). Free tools, never sleep, disk encryption on.
  4. Your private copy on GitHub (5 min). Your copy, your account, private.
  5. Tailscale (10 min). A private network only your devices can join.
  6. The hub is up (10 min). First milestone: the web console works.
  7. Backups (15 min). Nightly, encrypted, to storage you own, tested with a real restore.
  8. Apple team and Xcode (10 min). Once Apple says yes.
  9. The apps (20 min). The desktop app opens, the iPhone app installs and buzzes.
  10. Your first goals (15 min). The agent interviews you.
  11. Weekly updates and wrap-up (5 min).

How security works

Your data lives on your Mac. The hub listens only on your private Tailscale network, so nothing about it is public.

Security diagram for life: the iPhone app, the Mac app on your laptop and any browser talk to the hub on a Mac you leave on, such as a Mac mini, inside your private Tailscale network, where your data lives. Only four things leave the hub's Mac: Claude sessions to Anthropic, push notifications to Apple, nightly backups encrypted on the Mac first to your Backblaze bucket, and an opt-in weekly usage heartbeat with counts only. The public internet has no way in.

Updates and addenda

FAQ

Do I need to know how to code? No. The agent runs every command. You click, copy and paste where it tells you.

Is my data sent anywhere? Your Claude sessions go to Anthropic, like any Claude Code session. Push notifications go through Apple. Backups go to your own Backblaze bucket, encrypted first. Nothing else, unless you opt in to the counts-only heartbeat (to PostHog).

Can I skip the iPhone app? Yes. Pick web only and skip the Apple Developer membership. The console works in any browser on your Tailscale network, phone included.

Does it run on Windows or Linux? The hub needs a Mac. Once it runs, the web console works from any device on your Tailscale network.

Can the agent spend my money or email people on its own? No. Those actions are gated. It proposes, you approve with your decider code.

Is this an Anthropic product? No. It's an independent open source project built on Claude Code.

What's in the folders? hub/ is the server on your Mac and the web console it serves. app/ is the iPhone and desktop app. shared/ is the contract between them, so the two sides agree by test. ops/ is the scripts that run one install: build and start the hub, back it up nightly, install the apps, screenshot the pages. Those scripts are the only commands a session may run, so that folder is also the list of what the agent can do to your Mac.

Who made this

Matt Abate, @laundry_matt on X. Questions and ideas: open an issue. Want it set up for you or your team? Get in touch through mattabate.com.

Found a security hole? Report it privately, not in an issue.

License

MIT. See LICENSE.

life-distributable (mattabate/life-distributable)

正在搜索数据库…

这是什么?这是一个基于 Claude Code 搭建的可自托管 AI 智能体团队,旨在帮你实现目标。它运行在你自己拥有的 Mac 上,你可以通过 iPhone、Mac 或网页应用与这些智能体对话。
这是应用、框架还是库?这是一个应用:由一组在你的 Mac 上长期运行的 Claude Code 会话组成,另外还有 iPhone 应用、桌面应用和网页控制台,用来与它们交互。
我该怎么把它跑起来?在 Mac 上打开 Claude Code,粘贴 README 中的安装提示词。之后智能体会引导你完成设置,大约需要 2 小时,其中大部分时间在等待 Apple 和 Xcode 下载。
开始之前我需要准备什么?一台长期开机的 Mac、一个 Claude Pro 或 Max 订阅(每月 20 到 200 美元),以及 Tailscale(免费)。Apple 开发者会员(每年 99 美元)是可选的,仅在使用 iPhone 应用和桌面应用时才需要。
开始之前有什么要注意的吗?Apple 通常会在几小时内答复开发者注册申请。README 还说明,所有内容都只是可能变更的起点。作者同时提醒,使用需自担风险,因为智能体可能会花钱、发送消息、删除文件和分享数据。
我需要懂技术吗?不需要。智能体会执行所有命令,你只需在它指示的地方点击、复制和粘贴。
它能在 Windows 或 Linux 上运行吗?不能,中枢需要在 Mac 上运行。运行之后,网页控制台可以在你 Tailscale 网络中的任何设备上使用,包括手机和笔记本电脑。
能不能把它运行在云服务器上,而不是我的 Mac 上?不能。中枢运行在 macOS 上,设计上需要你自己拥有且长期开机的 Mac。
智能体能自己花我的钱或给别人发邮件吗?不能。花钱、删除文件、联系他人、分享数据或推送代码,都需要你批准,还需要只有你掌握的决策码。
智能体之间怎么分工?每个智能体都是一个长期运行的 Claude Code 会话,并有各自的角色,例如幕僚长或技术总监。当任务的一部分需要其他角色的专业知识时,它们会把任务交给彼此。
安装之后还会有新功能吗?会。新的修复每周都会发布到 ADDENDA.md,你的智能体会把每一项以卡片的形式展示出来。在你同意之前,不会应用任何更改。
我可以不装 iPhone 应用吗?可以。只选择网页版,并跳过 Apple 开发者会员即可。控制台可以在你 Tailscale 网络中的任何浏览器里使用,包括手机。
有哪些类似的项目?distilly, nanoMuse, Agentlas-OS, shipyard, happy, Dodaios, zulu, sill
作者
mattabate
大小
32.6 MB
星标
423
时长
1个月
提交 · 90 天