Porch：面向 Claude Code 和 Codex 会话的 Mac 菜单栏工作日志

为你的编码代理提供的开源工作日志。

一款 Mac 应用，按项目、日、周和月汇总你的 Claude Code 和 Codex 工作：你做了什么、时间花在哪里、卡在哪里。

下载 macOS 版 · 文档 · 한국어

功能

• 总结 — 按项目汇总你每天、每周和每月做了什么，包含每个任务的预估时间以及卡在哪里。超过 10 分钟的休息不计入，并行工作只计一次；当记录无法说明某件事为何卡住时，总结会如实说明。未完成的工作和阻塞项会一直延续，直到记录显示它们已完成。
• 笔记与通知 — 总结还可以保存为你所选文件夹中的 Markdown 文件，通常是 Obsidian 库（格式）。保存或重写总结会替换其笔记，包括其中的编辑，所以请把你的个人笔记放在别处，并从那里链接到 porch 笔记。自动总结完成后，通知会显示其一行摘要。
• 会话 — 此 Mac 上的 Claude Code 和 Codex 会话，无论由哪个终端或编辑器启动，以及哪些在等待你。菜单栏会显示数量。
• 用量 — 按项目、模型和工具统计的 token 和 API 等效成本，以及 Claude 和 Codex 的 5 小时和每周限额。API 等效成本是 token 乘以公开 API 价格，不是你的订阅账单。porch 用于撰写总结所消耗的 token 不计入。

安装

1. 下载 Porch.dmg 并将 Porch 移到“应用程序”。
2. 打开它，在 开启会话检测 下按 开启。你的代理设置会先备份，其他工具的钩子不受影响。下次启动 Codex 时，批准新的钩子，以便 Codex 会话显示出来。
3. 按 开始使用。在 总结 中，选择一个有记录工作的日期，然后按 生成总结。

需要 Apple Silicon Mac。总结需要安装并登录 Claude Code 或 Codex；在 设置 的 总结代理 下选择其一。Claude 限额需要 Pro 或 Max 套餐，并在 设置 中开启 导入 Claude 限额。要从源码构建，请参阅 CONTRIBUTING.md。

CLI

在 设置 中开启 终端命令，将 /usr/local/bin/porch 链接到应用内的副本（可能会要求输入密码）。CLI 读取与应用相同的记录。

porch now       # sessions and which ones wait on you (--json for scripts)
porch today     # today's summary (--date, --md, --json, --refresh)
porch week      # this week's summary (month for the month)
porch usage     # tokens and cost as JSON
porch limits    # Claude and Codex limits as JSON
porch help      # every command

尚未保存的总结会调用模型，因此调用 porch 的编码代理应仅使用只读命令，例如 porch now --json、porch usage 和 porch today --no-llm --json。

隐私

• 你的工作记录无需 porch 账户或服务器。会话状态、token 和成本永远不会离开你的 Mac，钩子不会发送任何内容。
• 总结、建议、阻塞项分类和每周评估会通过你选择的代理，将所需内容发送给模型：Claude Code（发送给 Anthropic）或 Codex（发送给 OpenAI）。
• 应用会向 PostHog 发送匿名使用事件。可在 设置 中通过 发送应用使用事件 关闭。

应用读取、存储和发送的所有内容，以及网站和下载链接统计的内容：docs/privacy.md。

支持的代理

任一 agent 都会为两个 agent 的记录撰写摘要。通过 OpenRouter 路由的模型费用是基于最便宜提供商的下限；没有已知价格的模型仅显示 token 数。想要另一个 agent？请提交 issue，说明它在哪里保存会话记录。

更多

• docs/：状态规则、决策与设计
• AGENTS.md：构建、测试与仓库规则，面向人员和编码 agent
• CONTRIBUTING.md · SECURITY.md

许可证

AGPL-3.0-only。版权所有 (C) 2026 amone-labs。如需贡献，请参阅 CONTRIBUTING.md。