Claude Pulse

English

Claude Pulse is a lightweight macOS window app for monitoring a local Claude Code proxy workflow.

It is designed for macOS users who already keep Claude Code state under ~/.claude/ and a local GOST proxy log under ~/Library/Logs/gost-claude.log.

What it does

• Runs a boot-time self-check when the app starts
• Verifies ~/.claude/settings.json
• Checks local reachability for 127.0.0.1:27990
• Probes api.ipify.org, api.anthropic.com, and platform.claude.com through the configured proxy
• Summarizes recent Claude-related activity from ~/Library/Logs/gost-claude.log
• Shows the most recent Claude main sessions and whether each session has subagents
• Exports a selected Claude session to Markdown on demand with a manifest.json
• Exposes a launch-at-login toggle from the app UI

Build and package

cd /path/to/ClaudePulse
swift test
./Scripts/build_icon.sh
./Scripts/package_app.sh release

Output

The default packaged app bundle is written under dist/ as:

dist/Claude Pulse.app

Session exports are written into:

Exports/ClaudeSessions

Run

Open the generated .app bundle in Finder, or run:

open "dist/Claude Pulse.app"

License

MIT

中文

Claude Pulse 是一个用于监测本地 Claude Code 代理工作流的轻量级 macOS 窗口应用。

它面向已经把 Claude Code 状态放在 ~/.claude/、并把本地 GOST 日志写到 ~/Library/Logs/gost-claude.log 的 macOS 用户。

它能做什么

• 应用启动时自动执行一次开机自检
• 校验 ~/.claude/settings.json
• 检查 127.0.0.1:27990 本地代理入口是否可达
• 通过当前代理探测 api.ipify.org、api.anthropic.com 和 platform.claude.com
• 从 ~/Library/Logs/gost-claude.log 汇总最近的 Claude 相关活动
• 展示最近活跃的 Claude 主会话，并标记每个会话是否带有子代理日志
• 在你点击时把选中的 Claude 会话导出为 Markdown 和 manifest.json
• 在应用界面中提供开机自启动开关

构建与打包

cd /path/to/ClaudePulse
swift test
./Scripts/build_icon.sh
./Scripts/package_app.sh release

产物位置

默认会在 dist/ 下生成这个 .app 包：

dist/Claude Pulse.app

会话导出结果会写入：

Exports/ClaudeSessions

运行方式

可以直接在 Finder 里打开生成的 .app，或者执行：

open "dist/Claude Pulse.app"

许可证

MIT