cc-pets 2.3.0 → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CC_BRIDGE.md +19 -0
- package/CC_BRIDGE.zh-CN.md +15 -0
- package/CHANGELOG.md +51 -0
- package/CHANGELOG.zh-CN.md +51 -0
- package/CONTRIBUTING.md +22 -0
- package/CONTRIBUTING.zh-CN.md +17 -0
- package/README.md +117 -26
- package/README.zh-CN.md +92 -22
- package/Resources/AgentIcons/claude.png +0 -0
- package/Resources/AgentIcons/codex.icns +0 -0
- package/Resources/IDEPlugins/cc-pets-terminal.vsix +0 -0
- package/Resources/IDEPlugins/cc-pets-terminal.zip +0 -0
- package/Resources/zh-Hans.lproj/Localizable.strings +155 -27
- package/Sources/CCPets/App/CCPetsAppDelegate+AgentStatus.m +12 -6
- package/Sources/CCPets/App/CCPetsAppDelegate+Private.h +1 -1
- package/Sources/CCPets/App/CCPetsAppDelegate+Settings.m +3 -6
- package/Sources/CCPets/App/CCPetsAppDelegate+Speech.m +113 -47
- package/Sources/CCPets/App/CCPetsAppDelegate.h +2 -2
- package/Sources/CCPets/App/main.m +6 -0
- package/Sources/CCPets/Bridge/CCPetsBridge.m +11 -6
- package/Sources/CCPets/Bridge/CCPetsBridgeCLI.m +78 -38
- package/Sources/CCPets/Bridge/CCPetsBridgeCore.h +2 -3
- package/Sources/CCPets/Bridge/CCPetsBridgeCore.m +50 -32
- package/Sources/CCPets/Bridge/CCPetsBridgeSetup.m +46 -40
- package/Sources/CCPets/Bridge/CCPetsBridgeStore.h +9 -6
- package/Sources/CCPets/Bridge/CCPetsBridgeStore.m +171 -53
- package/Sources/CCPets/Integrations/CCPetsIDEIntegration.h +21 -0
- package/Sources/CCPets/Integrations/CCPetsIDEIntegration.m +503 -0
- package/Sources/CCPets/Integrations/CCPetsLaunchPreflight.h +5 -0
- package/Sources/CCPets/Integrations/CCPetsLaunchPreflight.m +367 -0
- package/Sources/CCPets/Integrations/CCPetsTerminalFocus.h +2 -1
- package/Sources/CCPets/Integrations/CCPetsTerminalFocus.m +107 -25
- package/Sources/CCPets/Integrations/CCPetsTerminalIntegration.h +17 -0
- package/Sources/CCPets/Integrations/CCPetsTerminalIntegration.m +64 -0
- package/Sources/CCPets/Integrations/CCPetsVSCodeIntegration.h +23 -0
- package/Sources/CCPets/Integrations/CCPetsVSCodeIntegration.m +475 -0
- package/Sources/CCPets/Pet/PetView+Menu.m +2 -2
- package/Sources/CCPets/Support/CCPetsDoctor.m +26 -12
- package/Sources/CCPets/Support/CCPetsPreferences.h +2 -0
- package/Sources/CCPets/Support/CCPetsPreferences.m +34 -2
- package/Sources/CCPets/UI/CCPetsFormBuilder.h +2 -0
- package/Sources/CCPets/UI/CCPetsFormBuilder.m +18 -7
- package/Sources/CCPets/UI/CCPetsGlassView.h +26 -4
- package/Sources/CCPets/UI/CCPetsGlassView.m +40 -9
- package/Sources/CCPets/UI/CCPetsSettingsPage.h +2 -0
- package/Sources/CCPets/UI/CCPetsSettingsPage.m +561 -66
- package/Sources/CCPets/UI/CCPetsUIStyle.h +5 -2
- package/Sources/CCPets/UI/CCPetsUIStyle.m +57 -8
- package/Sources/CCPets/UI/CCPetsUsageChartView.m +4 -0
- package/Sources/CCPets/UI/CCPetsUsagePage.m +23 -28
- package/Sources/CCPets/UI/CCPetsUsageStore.m +2 -2
- package/Sources/CCPets/Usage/CCPetsUsage+CodexBackground.m +193 -0
- package/Sources/CCPets/Usage/CCPetsUsage+Internal.h +1 -0
- package/Sources/CCPets/Usage/CCPetsUsage+Models.m +49 -11
- package/Sources/CCPets/Usage/CCPetsUsage.h +3 -2
- package/Sources/CCPets/Usage/CCPetsUsageMonitor.m +15 -17
- package/Sources/CCPets/Usage/QuotaDashboardView+Rendering.m +11 -29
- package/Sources/CCPets/Usage/QuotaDashboardView.m +128 -2
- package/THIRD_PARTY_NOTICES.md +7 -3
- package/THIRD_PARTY_NOTICES.zh-CN.md +5 -1
- package/bin/claude-with-pet +2 -0
- package/bin/codex-with-pet +2 -0
- package/package.json +5 -1
- package/plugins/jetbrains/README.md +62 -0
- package/plugins/jetbrains/src/main/java/com/ccpets/terminal/TerminalBridge.java +379 -0
- package/plugins/jetbrains/src/main/java/com/ccpets/terminal/TerminalIdentity.java +24 -0
- package/plugins/jetbrains/src/main/java/com/ccpets/terminal/TerminalStartup.java +12 -0
- package/plugins/jetbrains/src/main/resources/META-INF/plugin.xml +23 -0
- package/plugins/jetbrains/src/main/resources/META-INF/pluginIcon.svg +380 -0
- package/plugins/vscode/README.md +63 -0
- package/plugins/vscode/extension.js +210 -0
- package/plugins/vscode/package.json +18 -0
- package/scripts/build-idea-plugin.sh +101 -0
- package/scripts/build-vscode-extension.sh +112 -0
- package/scripts/build.sh +24 -2
- package/scripts/compile-cached.zsh +133 -0
package/CC_BRIDGE.md
CHANGED
|
@@ -245,3 +245,22 @@ tool through `~/.cc-pets/bridge-cli.json`, written on every `cc-pets install`; i
|
|
|
245
245
|
10 minutes is paused to stop two agents from auto-replying to each other in a loop.
|
|
246
246
|
- Pet status cards and notifications never show message bodies.
|
|
247
247
|
- No background daemon: only hooks, the MCP server, and the watcher inside Claude sessions, all of which exit with the session.
|
|
248
|
+
|
|
249
|
+
## Identity and delivery guarantees
|
|
250
|
+
|
|
251
|
+
Bridge validates `CODEX_THREAD_ID` / `CLAUDE_CODE_SESSION_ID` against the live session registry and the
|
|
252
|
+
current host process. Without a session ID, PID lookup is allowed only when it identifies exactly one
|
|
253
|
+
live session. Ambiguous shared hosts and stale explicit IDs fail closed for sending, renaming, reading
|
|
254
|
+
inboxes and managing reservations. CLI diagnostics can select a session explicitly with
|
|
255
|
+
`--from <session-name-or-full-session-id>`.
|
|
256
|
+
|
|
257
|
+
Claimed inbox messages remain on disk until the complete output has been flushed successfully.
|
|
258
|
+
A later hook, watcher or `check_inbox` recovers unconfirmed messages after a crash. A crash between
|
|
259
|
+
output and confirmation may deliver the same message ID again; the host provides no acknowledgement
|
|
260
|
+
protocol, so exactly-once delivery is not guaranteed. Codex queue delivery uses the recipient's Home.
|
|
261
|
+
Legacy records with an unknown Home fall back to the inbox until registration is refreshed by input
|
|
262
|
+
in that session.
|
|
263
|
+
|
|
264
|
+
Existing watchers recheck the enabled and auto-wake switches while polling. Disabling Bridge also
|
|
265
|
+
blocks CLI send, rename and inbox operations. Integration removal failures return a nonzero exit code;
|
|
266
|
+
the runtime remains disabled, and `disable` can be retried after resolving the reported errors.
|
package/CC_BRIDGE.zh-CN.md
CHANGED
|
@@ -48,6 +48,9 @@ cc-pets bridge configure --edit-guard=off # 关闭编辑前预留拦截
|
|
|
48
48
|
| `--wake=on\|off` | 自动唤醒空闲会话,默认开。关闭后消息只进信箱,等对方下次收到你的输入时带入,可省 token |
|
|
49
49
|
| `--edit-guard=on\|off` | 编辑他人预留的文件时暂停一次,默认开 |
|
|
50
50
|
|
|
51
|
+
运行中的 watcher 会在轮询时检查关闭状态;关闭自动唤醒后不再主动取信,关闭 Bridge 后 CLI 也拒绝发送、改名和收件。
|
|
52
|
+
卸载集成失败会返回非零退出码,运行时开关仍保持关闭,可排除错误后再次执行 `disable`。
|
|
53
|
+
|
|
51
54
|
Claude 侧的改动会被热加载;Codex 侧(审批、hooks)需要重启 Codex 会话,hooks 变化后还要在 `/hooks` 中重新信任。
|
|
52
55
|
|
|
53
56
|
## 使用
|
|
@@ -143,6 +146,13 @@ CC_BRIDGE_NAME=api codex
|
|
|
143
146
|
- 开启 CC Bridge 之前就在运行的 Claude 会话能收消息,但没有这些工具,只能在 shell 里用 `cc-pets bridge send` 回复;重启一下最省事。
|
|
144
147
|
- 留意桌宠:状态图标右下角出现蓝色数字,说明会话之间有往来;点开能看到谁发给了谁,点一下即跳到对应终端(见下文)。
|
|
145
148
|
|
|
149
|
+
### 身份识别与共享宿主
|
|
150
|
+
|
|
151
|
+
Bridge 优先验证当前进程提供的 `CODEX_THREAD_ID` / `CLAUDE_CODE_SESSION_ID`,包括注册记录、
|
|
152
|
+
在线状态和宿主是否一致。没有会话 ID 时,仅允许宿主 PID 唯一匹配一个在线会话。
|
|
153
|
+
多个会话共享 PID 且缺少可靠 ID,或显式 ID 已失效时,会明确拒绝发送、改名、收件和文件预留等操作,
|
|
154
|
+
不会按最近活跃时间猜测。CLI 排查时可用 `--from <会话名或完整会话 ID>` 显式指定身份。
|
|
155
|
+
|
|
146
156
|
## 文件预留
|
|
147
157
|
|
|
148
158
|
多个 Agent 在同一个仓库里工作时,最怕两个会话同时改同一个文件。文件预留让 Agent 在开始较大的修改前
|
|
@@ -175,6 +185,11 @@ Claude Code 的 watcher 在会话启动和每轮结束时挂上,每次最多
|
|
|
175
185
|
|
|
176
186
|
发送方只会收到"已送达队列 / 已放入信箱 / 无法投递"这类回执。送达不代表对方已读,也不代表对方同意。
|
|
177
187
|
|
|
188
|
+
信箱消息认领后保留在 `claimed`,完整输出并刷新输出流成功后才确认。进程异常退出时,下一次
|
|
189
|
+
hook、watcher 或 `check_inbox` 会恢复未确认消息。在输出已到达宿主、确认尚未落盘的瞬间崩溃,
|
|
190
|
+
恢复后可能重复投递同一个消息 ID;目前没有宿主确认协议,无法保证恰好一次送达。
|
|
191
|
+
跨账号投递 Codex 使用接收方注册的 Home;旧记录无法确定 Home 时保留到信箱,等待该会话输入后刷新注册。
|
|
192
|
+
|
|
178
193
|
## 桌宠里的显示
|
|
179
194
|
|
|
180
195
|
开启 CC Bridge 后,桌宠状态卡的圆形图标右下角会多一个消息角标(右上角的红色角标仍是待审批):
|
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,57 @@ truth for the version.
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [2.4.0] - 2026-11-03
|
|
11
|
+
|
|
12
|
+
### Diagnostics
|
|
13
|
+
|
|
14
|
+
- Distinguish local source packages, local npm packages and unknown local package locations in Diagnostics, copied reports and `cc-pets paths`. Local version mismatch warnings no longer imply that a version has been published on npm; published updates are checked separately.
|
|
15
|
+
|
|
16
|
+
### Terminal jump and settings
|
|
17
|
+
|
|
18
|
+
- Add exact terminal selection for JetBrains 2026.2 / 2026.3 Reworked terminals through the bundled plugin, including terminals moved into editor tabs. Classic terminals, remote development and split subterminals are outside the supported scope. Ghostty 1.4+ selects tabs and splits by TTY; iTerm2 selects sessions by TTY. Automation permission is required for script-based terminal jumps.
|
|
19
|
+
- Put Panel Appearance first in Settings, with compact theme tiles and a live Liquid Glass dimming preview. Dimming is displayed as 0–100 while retaining the existing internal range; menu presets are 0/25/50/100. Combine terminal integration states in one card, group versions of the same JetBrains product and collapse lists longer than five rows.
|
|
20
|
+
|
|
21
|
+
### Pet management
|
|
22
|
+
|
|
23
|
+
- Delete pets from the user's own folder directly on the Main menu's Pet page, using a hover button or context menu and a confirmation dialog. Built-in pets and the currently selected pet are protected. Refresh the picker when pets are added or removed through the CLI, Finder or the pet menu.
|
|
24
|
+
|
|
25
|
+
### Token accounting
|
|
26
|
+
|
|
27
|
+
- Correct Codex cache-write double counting and migrate existing daily archives. Incrementally include background usage from local Codex SQLite logs, excluding sessions already represented by persisted transcripts. Background totals do not invent an input/output/cache breakdown.
|
|
28
|
+
- Keep individual chart series and colors for every model instead of folding models after the eighth into Other. Restore native tooltips for usage metrics.
|
|
29
|
+
|
|
30
|
+
### VS Code terminal jump
|
|
31
|
+
|
|
32
|
+
- Add the CC Pets Terminal extension for VS Code 1.80+ and its forks (Cursor, Windsurf, VSCodium, …). Clicking an agent card selects the exact integrated terminal by TTY — in the panel, a split or the editor area — and brings its window forward by reopening that window's workspace, switching Spaces when needed. Forks are recognised by `product.json`, not a bundle ID list. Remote windows are not supported; without the extension the app is only brought forward, as before.
|
|
33
|
+
- Settings → Terminal Jump lists each VS Code family app with install, update, reload-needed and disabled states. Install runs the app's own command line tool on the bundled VSIX after confirmation, with a manual "Install from VSIX…" fallback. The VSIX is built reproducibly with macOS tools only (`scripts/build-vscode-extension.sh`).
|
|
34
|
+
|
|
35
|
+
### Build reliability
|
|
36
|
+
|
|
37
|
+
- Replace cached and uncached executables atomically after signing and verification, including the App's executable. This fixes macOS signature-related termination after in-place overwrites that could break Hooks, CLI launch and tests. Builds now check CLI execution before reporting success; early test failures report their phase, location and exit status.
|
|
38
|
+
|
|
39
|
+
### CC Bridge
|
|
40
|
+
|
|
41
|
+
- Validate explicit session IDs before PID lookup and reject ambiguous shared-host identities instead of selecting the most recently active session. This protects messaging, renaming, inbox access and file reservations.
|
|
42
|
+
- Retain claimed inbox messages until output is flushed successfully, recover unconfirmed messages after crashes, and prevent delivered receipts from reverting to pending. Recovery can repeat a message ID if a crash occurs between output and confirmation; exactly-once delivery is not guaranteed.
|
|
43
|
+
- Serialize session updates and renaming, use kernel-backed watcher locks, and preserve numeric suffixes when allocating duplicate 40-character session names.
|
|
44
|
+
- Recheck enabled and auto-wake settings in running watchers, reject CLI mutations while disabled, and report integration removal failures with a nonzero exit code while keeping the runtime disabled.
|
|
45
|
+
- Use the recipient's Codex Home for queue delivery, recognize literal bracketed file paths such as `[id]` in reservation checks, and preserve account and sender IDs for Bridge activity display.
|
|
46
|
+
- Shorten the cross-session message envelope to a source line, a one-line permission notice and a reply address that includes the sender's ref. MCP instructions now ask the receiving session to reply to the originating session with `send_message` when it needs clarification or finishes the request.
|
|
47
|
+
|
|
48
|
+
### Launch protection
|
|
49
|
+
|
|
50
|
+
- Added an optional Shadowrocket launch check under **Main menu → Settings → Launch Protection** (off by default). Before registering a session or sending a starting event, wrappers verify the VPN connection and request each service's `/cdn-cgi/trace`. Mainland China (CN), Hong Kong (HK), unknown exits and failed requests block launch; successful checks show the exit IP and region.
|
|
51
|
+
- Claude defaults to `api.anthropic.com`; Codex selects `chatgpt.com` or `api.openai.com` from its `auth.json` login mode, checking both when unknown. Common user-level endpoint settings are supported; custom endpoints must return valid trace data, with no unrelated-domain fallback. Removed separate DNS / homepage HEAD probes. Requests send no account credentials, verify TLS, ignore `~/.curlrc` and do not follow redirects. See README for complex configuration, project override and cloud-provider limitations. Launches bypassing wrappers are not checked.
|
|
52
|
+
- Exit checks allow 8 seconds to connect and 15 seconds per request, with a 16-second process watchdog. Temporary transport failures and HTTP 502 / 503 / 504 retry once after 1 second. Failures report the timeout phase, attempt count and cumulative connection timings. Wrapper tests use a fresh preferences domain per run, keeping real VPN settings and network probes out of ordinary tests while preserving compile caching and phase timing.
|
|
53
|
+
|
|
54
|
+
### Quota and interface
|
|
55
|
+
|
|
56
|
+
- Track low-quota speech independently for each subscription account at the 20%, 10% and 5% thresholds. Queue reminders during cooldown, identify the triggering account, skip the first sample and expired windows, and exclude API-usage accounts. General quota placeholders use the account with the least remaining quota.
|
|
57
|
+
- Apply the same Codex live-usage merge to default and custom Homes. Expire exhaustion markers from their original sampling time so repeated cache reads cannot extend their five-minute lifetime.
|
|
58
|
+
- Simplify the monthly token trend layout: show today's usage and recorded days on separate lines, with peak usage in a tooltip for the selected account.
|
|
59
|
+
- Normalize provider icon sizing and bundle fallback Claude and Codex icons for CLI-only installations. Include them in native builds and npm packages, and document their sources and separate ownership in the third-party notices.
|
|
60
|
+
|
|
10
61
|
## [2.3.0] - 2026-10-21
|
|
11
62
|
|
|
12
63
|
### Installation
|
package/CHANGELOG.zh-CN.md
CHANGED
|
@@ -6,6 +6,57 @@
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
+
## [2.4.0] - 2026-11-03
|
|
10
|
+
|
|
11
|
+
### 诊断
|
|
12
|
+
|
|
13
|
+
- 诊断页、复制报告与 `cc-pets paths` 区分本地源码包、本地 npm 包及无法确认来源的本地包。版本不一致提示明确比较本地安装,不再让人误以为对应版本已在 npm 发布;线上版本仍由更新检查单独查询。
|
|
14
|
+
|
|
15
|
+
### 终端跳转与设置
|
|
16
|
+
|
|
17
|
+
- 通过随包插件精确选择 JetBrains 2026.2 / 2026.3 Reworked 终端,支持移入编辑器标签页的终端;Classic 终端、远程开发及分屏内子终端不在支持范围内。Ghostty 1.4+ 按 TTY 选择标签页和分屏,iTerm2 按 TTY 选择会话;通过脚本跳转的终端需要 Automation 权限。
|
|
18
|
+
- 设置页将面板外观置顶,缩小主题卡片,并提供 Liquid Glass 压暗实时预览。压暗显示为 0–100,内部范围保持不变,菜单预设调整为 0/25/50/100。终端集成状态合并到一张卡片,同一 JetBrains 产品的多个版本合并展示,超过五行时折叠。
|
|
19
|
+
|
|
20
|
+
### 宠物管理
|
|
21
|
+
|
|
22
|
+
- 主菜单「宠物」页可通过悬停按钮或右键菜单删除用户素材目录内的宠物,删除前弹窗确认;内置宠物与当前选中的宠物受保护。通过 CLI、Finder 或桌宠菜单增删素材后,列表会刷新。
|
|
23
|
+
|
|
24
|
+
### Token 统计
|
|
25
|
+
|
|
26
|
+
- 修复 Codex cache write 重复计数并迁移已有按日归档;从本机 Codex SQLite 日志增量补充后台用量,排除已由持久化会话记录覆盖的部分。后台用量仅计入总量,不推算 input/output/cache 明细。
|
|
27
|
+
- 每个模型保留独立图表序列与颜色,第八个之后不再合并为 Other;用量指标恢复原生 tooltip。
|
|
28
|
+
|
|
29
|
+
### VS Code 终端跳转
|
|
30
|
+
|
|
31
|
+
- 新增 VS Code 1.80+ 及其分支(Cursor、Windsurf、VSCodium 等)的 CC Pets Terminal 扩展。点击 Agent 卡片时按 TTY 精确选中集成终端,面板、分屏和编辑器区均支持;通过重新打开该窗口的工作区把对应窗口前置,必要时切换桌面。分支按 `product.json` 识别,不维护 bundle ID 名单。远程窗口不支持;未安装扩展时仍只激活应用。
|
|
32
|
+
- 「设置 → 终端跳转」按应用列出 VS Code 家族,显示安装、更新、需要重新加载和已禁用等状态。确认后调用应用自带的命令行工具安装随包 VSIX,失败时可手动「从 VSIX 安装…」。VSIX 仅用 macOS 自带工具可复现构建(`scripts/build-vscode-extension.sh`)。
|
|
33
|
+
|
|
34
|
+
### 构建可靠性
|
|
35
|
+
|
|
36
|
+
- 缓存与无缓存构建均在签名校验后原子替换可执行文件,覆盖裸 CLI 和 App 内的程序,修复原地覆盖导致 macOS 因签名问题终止进程、连带 Hook、CLI 启动和测试失败的问题。构建报告成功前检查 CLI 能否执行;测试提前失败时显示阶段、位置与退出码。
|
|
37
|
+
|
|
38
|
+
### CC Bridge
|
|
39
|
+
|
|
40
|
+
- 优先验证显式会话 ID;按 PID 回退时遇到共享宿主的多个会话会拒绝操作,不再按最近活跃时间猜测身份,覆盖发消息、改名、收件和文件预留。
|
|
41
|
+
- 信箱消息在完整输出并刷新输出流成功前保留,异常退出后恢复未确认消息;已送达回执不会被迟到的更新覆盖为待投递。输出与确认之间崩溃时可能重复投递同一消息 ID,不保证恰好一次送达。
|
|
42
|
+
- 会话更新和改名串行化,watcher 改用内核锁;为重名的 40 字符会话名分配新名字时保留数字后缀,避免死循环。
|
|
43
|
+
- 运行中的 watcher 持续检查启用和自动唤醒开关;关闭后 CLI 拒绝修改操作;集成卸载失败返回非零退出码,运行时仍保持关闭。
|
|
44
|
+
- Codex 队列投递使用接收方的 Home;文件预留检查正确处理 `[id]` 等带方括号的真实路径;Bridge 活动展示保留账号和发送方会话 ID。
|
|
45
|
+
- 精简跨会话消息封装:只保留来源行、一行降权说明和带 ref 的回复地址;MCP 说明要求接收方在需要补充信息或任务完成时,用 `send_message` 回复来源会话。
|
|
46
|
+
|
|
47
|
+
### 启动保护
|
|
48
|
+
|
|
49
|
+
- 新增可选的小火箭(Shadowrocket)启动检查,位于「主菜单 → 设置 → 启动保护」,默认关闭。包装器在登记会话、发送 starting 事件之前检查 VPN 连接状态,并分别请求服务的 `/cdn-cgi/trace`。中国大陆(CN)、香港(HK)、未知出口及请求失败均阻止启动;成功显示出口 IP 和地区。
|
|
50
|
+
- Claude 默认检查 `api.anthropic.com`;Codex 按 `auth.json` 的登录模式检查 `chatgpt.com` 或 `api.openai.com`,模式未知时检查两者。支持用户级常见端点配置;自定义地址必须返回有效 trace,不回退到无关域名。移除独立 DNS / 首页 HEAD 探测,不携带账号凭据、校验 TLS 证书、忽略 `~/.curlrc`、不跟随重定向。复杂配置、项目网络覆盖及云服务商的支持边界见 README;绕过包装器的启动不受保护。
|
|
51
|
+
- 出口检测调整为连接时限 8 秒、单次请求时限 15 秒、进程保护时限 16 秒;临时传输故障和 HTTP 502 / 503 / 504 间隔 1 秒重试一次。失败时显示超时阶段、尝试次数及连接累计耗时。包装器测试每轮使用独立偏好域,避免读取真实 VPN 设置并发起网络探测,保留编译缓存和阶段计时。
|
|
52
|
+
|
|
53
|
+
### 额度与界面
|
|
54
|
+
|
|
55
|
+
- 低额度台词按订阅账号分别记录 20%、10%、5% 阈值,冷却时排队,播报注明触发账号;首次采样、过期额度和 API 用量账号不触发提醒。普通额度槽位使用剩余额度最低的账号。
|
|
56
|
+
- 默认和自定义 Home 统一合并 Codex 实时额度;耗尽标记按原始采样时间计算五分钟有效期,重复读取缓存不再延长有效期。
|
|
57
|
+
- 简化月度 Token 趋势排版,今日用量和记录天数分行显示,峰值移入当前所选账号的悬浮提示。
|
|
58
|
+
- 统一服务商图标的视觉尺寸;为仅安装 CLI 的环境随原生构建和 npm 包提供 Claude、Codex 备用图标,并在第三方声明中说明来源及独立版权归属。
|
|
59
|
+
|
|
9
60
|
## [2.3.0] - 2026-10-21
|
|
10
61
|
|
|
11
62
|
### 安装
|
package/CONTRIBUTING.md
CHANGED
|
@@ -13,6 +13,28 @@ Thank you for contributing to CC Pets. Before submitting a change:
|
|
|
13
13
|
For a substantial feature, open a GitHub Issue before sending a Pull Request so the
|
|
14
14
|
scope can be agreed on first.
|
|
15
15
|
|
|
16
|
+
## Build and test cache
|
|
17
|
+
|
|
18
|
+
`npm run build` and `npm test` share object files and linked binaries under
|
|
19
|
+
`.build/clang-cache/cc-pets`. Changes to sources, project headers, compiler flags,
|
|
20
|
+
the toolchain, or SDK invalidate the cache; temporary output paths do not.
|
|
21
|
+
Empty-resource builds, normal builds, and installation checks still refresh resources
|
|
22
|
+
and signatures. Every test runs each time; passing results are never cached.
|
|
23
|
+
Logs show compilation progress, compiled/reused counts, test phases, and elapsed time.
|
|
24
|
+
Executables are staged on the destination filesystem, ad-hoc signed and verified, then
|
|
25
|
+
atomically renamed into place. This also applies when the cache is disabled; executable
|
|
26
|
+
files must not be overwritten in place on macOS. Builds check that the resulting CLI can
|
|
27
|
+
run `--version`, and early test failures report their phase, location, and exit status.
|
|
28
|
+
|
|
29
|
+
The test runner assigns a fresh `CC_PETS_PREFERENCES_DOMAIN` on every run. Changing
|
|
30
|
+
`HOME` alone does not isolate macOS `CFPreferences`. Launch protection defaults to off
|
|
31
|
+
in this domain, so wrapper and shim tests do not depend on your VPN or live exit probes.
|
|
32
|
+
|
|
33
|
+
Use `CC_PETS_NO_BUILD_CACHE=1 npm run build` or `CC_PETS_NO_BUILD_CACHE=1 npm test`
|
|
34
|
+
to bypass the cache and compile with the original clang command. This does not read
|
|
35
|
+
or write this cache. The existing `cc-pets clean` command removes these artifacts
|
|
36
|
+
along with the application's other caches.
|
|
37
|
+
|
|
16
38
|
## Branch and release policy
|
|
17
39
|
|
|
18
40
|
Develop, test, and prepare preview releases on `publish`. Preview releases must be
|
package/CONTRIBUTING.zh-CN.md
CHANGED
|
@@ -12,6 +12,23 @@
|
|
|
12
12
|
|
|
13
13
|
建议先开一个 GitHub Issue 描述较大的功能改动,达成一致后再提交 Pull Request。
|
|
14
14
|
|
|
15
|
+
## 构建与测试缓存
|
|
16
|
+
|
|
17
|
+
`npm run build` 与 `npm test` 共用 `.build/clang-cache/cc-pets` 下的目标文件和链接产物。
|
|
18
|
+
源码、项目头文件、编译参数、工具链或 SDK 变化时自动失效;临时输出目录的变化不影响复用。
|
|
19
|
+
空素材构建、正常构建和安装测试仍会更新资源与签名,所有测试每次都执行,不缓存通过结果。
|
|
20
|
+
日志显示当前编译文件、编译/复用数量、测试阶段及耗时。
|
|
21
|
+
可执行文件先在目标文件系统中暂存,完成临时签名与校验后再原子替换;关闭缓存时也使用此流程,
|
|
22
|
+
避免在 macOS 上原地覆盖可执行文件。构建完成前确认 CLI 可以执行 `--version`,
|
|
23
|
+
测试提前失败时输出所属阶段、代码位置与退出码。
|
|
24
|
+
|
|
25
|
+
测试入口每轮设置全新的 `CC_PETS_PREFERENCES_DOMAIN`。仅修改 `HOME` 无法隔离 macOS
|
|
26
|
+
`CFPreferences`;独立偏好域中的启动保护默认关闭,包装器和 shim 测试不依赖本机 VPN 或真实出口探测。
|
|
27
|
+
|
|
28
|
+
需要绕过缓存完整重编译时,使用 `CC_PETS_NO_BUILD_CACHE=1 npm run build`,
|
|
29
|
+
或 `CC_PETS_NO_BUILD_CACHE=1 npm test`。该开关直接使用原始 clang 命令,不读写这份缓存。
|
|
30
|
+
缓存位于现有构建缓存目录内,`cc-pets clean` 清理应用缓存时也会一并清理它。
|
|
31
|
+
|
|
15
32
|
## 分支与发布规则
|
|
16
33
|
|
|
17
34
|
在 `publish` 完成开发、修改、测试和测试版本准备。测试版本必须在 GitHub 标记为
|
package/README.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="docs/images/cover.png" alt="CC Pets v2.
|
|
2
|
+
<img src="docs/images/cover.png" alt="CC Pets v2.4.0: Exact terminal jumps, launch protection and usage improvements">
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
# CC Pets
|
|
@@ -13,25 +13,21 @@ Codex App Server interface and Claude Code's official status line input.
|
|
|
13
13
|
|
|
14
14
|
> The app and CLI are available in English and Simplified Chinese (see [Language](#language)).
|
|
15
15
|
|
|
16
|
-
## What's new in v2.
|
|
16
|
+
## What's new in v2.4.0
|
|
17
17
|
|
|
18
|
-
- **
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
- **Native runtime and diagnostic repairs** — hooks, CC Bridge and CLI tools run
|
|
25
|
-
without Node.js. Repair registered accounts' hooks and Claude status lines
|
|
26
|
-
from Diagnostics, with configuration backups before changes.
|
|
18
|
+
- **Exact terminal jumps** — select terminals in VS Code and its forks, JetBrains,
|
|
19
|
+
Ghostty and iTerm2, with permissions and extension management in Settings.
|
|
20
|
+
- **Launch protection and CC Bridge** — optional Shadowrocket exit checks before
|
|
21
|
+
wrapper launches, safer session identity matching and recoverable inbox delivery.
|
|
22
|
+
- **Usage and pet management** — corrected Codex token accounting, background usage,
|
|
23
|
+
per-account quota reminders, refreshed appearance settings and custom pet deletion.
|
|
27
24
|
|
|
28
|
-
See the [changelog](./CHANGELOG.md) and [release notes](./docs/release-notes-v2.
|
|
25
|
+
See the [changelog](./CHANGELOG.md) and [release notes](./docs/release-notes-v2.4.0.md) for the full list.
|
|
29
26
|
|
|
30
27
|
## Screenshots
|
|
31
28
|
|
|
32
29
|
<p align="center">
|
|
33
|
-
<img src="docs/images/liquid-glass-panel.en.png" width="
|
|
34
|
-
<img src="docs/images/liquid-glass-menu.en.png" width="45%" alt="English right-click menu with English selected in the Language submenu">
|
|
30
|
+
<img src="docs/images/liquid-glass-panel.en.png" width="48%" alt="English Agent Usage panel with quota, tokens, trends, and system status"> <img src="docs/images/liquid-glass-menu.en.png" width="48%" alt="English right-click menu with English selected in the Language submenu">
|
|
35
31
|
</p>
|
|
36
32
|
|
|
37
33
|
## Features
|
|
@@ -109,10 +105,11 @@ the list after 60 idle seconds.
|
|
|
109
105
|
|
|
110
106
|
Every hook status card is clickable. The circular status icon lists up to eight
|
|
111
107
|
recent online Agent terminal sessions. Terminal.app and iTerm2 are selected
|
|
112
|
-
precisely by TTY.
|
|
113
|
-
|
|
114
|
-
an
|
|
115
|
-
|
|
108
|
+
precisely by TTY; Ghostty 1.4+ also selects the exact tab and split. VS Code and
|
|
109
|
+
JetBrains IDEs use their bundled extensions for exact terminal selection. Without
|
|
110
|
+
an extension, or for Warp, WezTerm and older Ghostty versions, the owning app is
|
|
111
|
+
brought forward. macOS may request Automation permission for Terminal.app, iTerm2
|
|
112
|
+
and Ghostty. Manage permissions and extensions in Settings → Terminal Jump.
|
|
116
113
|
|
|
117
114
|
### Install from source
|
|
118
115
|
|
|
@@ -157,6 +154,58 @@ Bridge is already enabled, its Hooks, permissions, and MCP registration are also
|
|
|
157
154
|
configured immediately; otherwise they are added automatically when CC Bridge is
|
|
158
155
|
enabled later.
|
|
159
156
|
|
|
157
|
+
## Shadowrocket launch check
|
|
158
|
+
|
|
159
|
+
Enable **Main menu → Settings → Launch Protection → Shadowrocket** (off by default).
|
|
160
|
+
Each proxy app has its own preference; Shadowrocket is the first supported option.
|
|
161
|
+
CC Pets wrappers require a connected Shadowrocket VPN and a valid exit IP / region from
|
|
162
|
+
the service's HTTPS `/cdn-cgi/trace` endpoint before starting Claude / Codex. Failures
|
|
163
|
+
print a reason and return a nonzero exit code before registering a session or sending
|
|
164
|
+
a starting event. Disabling the option skips all network checks.
|
|
165
|
+
|
|
166
|
+
Claude defaults to `api.anthropic.com`. Codex uses the current Home's `auth.json` to select
|
|
167
|
+
`chatgpt.com` for ChatGPT login or `api.openai.com` for API-key login. If the mode is unknown
|
|
168
|
+
(for example, credentials stored only in Keychain), both exits must pass.
|
|
169
|
+
The response must contain valid `ip`, `loc` and matching `h` fields. `CN` and `HK` exits,
|
|
170
|
+
unknown regions, invalid responses, non-200 HTTP responses and connection / TLS / timeout
|
|
171
|
+
failures block launch. Successful probes print the domain, exit IP and region.
|
|
172
|
+
Each attempt has an 8-second connect timeout, a 15-second total request timeout and a
|
|
173
|
+
16-second process watchdog. Temporary transport failures and HTTP 502 / 503 / 504 retry
|
|
174
|
+
once after 1 second; VPN status is checked again before retrying. Two timed-out requests
|
|
175
|
+
take about 31 seconds per domain, plus VPN checks and process overhead. Blocked regions,
|
|
176
|
+
invalid trace responses and certificate errors are not retried. Failure messages distinguish
|
|
177
|
+
connection, response and process timeouts and include attempt counts and cumulative DNS /
|
|
178
|
+
TCP / TLS / response timings. There is no separate DNS lookup or homepage HEAD request.
|
|
179
|
+
Probes send no account credentials,
|
|
180
|
+
verify TLS certificates, ignore `~/.curlrc` and do not follow redirects.
|
|
181
|
+
|
|
182
|
+
Claude reads network environment settings from the current `CLAUDE_CONFIG_DIR/settings.json`
|
|
183
|
+
and terminal proxy variables, including an overridden `ANTHROPIC_BASE_URL`. Codex supports
|
|
184
|
+
common single-line string routing settings in `CODEX_HOME/config.toml` (`model_provider`,
|
|
185
|
+
`profile`, `model_providers.<id>.base_url`, `chatgpt_base_url`), `--profile` / `-p`,
|
|
186
|
+
`OPENAI_BASE_URL` and terminal proxy variables. Custom endpoints use their own origin's
|
|
187
|
+
`/cdn-cgi/trace`, with no fallback to another domain. Gateways must serve valid trace data;
|
|
188
|
+
this only describes the exit to the gateway, not the gateway's upstream exit.
|
|
189
|
+
Complex routing TOML, unsupported cloud providers, command-line configuration overrides
|
|
190
|
+
and project network overrides are rejected with an explanation. Enterprise-managed network
|
|
191
|
+
configuration is outside the supported scope. The check does not validate account access,
|
|
192
|
+
service-supported countries or future routing changes. It recognizes the Shadowrocket VPN
|
|
193
|
+
configuration, not just its running process. Original CLI binaries and desktop clients bypass it.
|
|
194
|
+
|
|
195
|
+
## CC Bridge
|
|
196
|
+
|
|
197
|
+
[CC Bridge](./CC_BRIDGE.md) is optional and off by default. It lets local Claude Code
|
|
198
|
+
and Codex sessions exchange messages and reserve files. Session IDs are validated;
|
|
199
|
+
PID fallback is accepted only for a unique live session. Ambiguous shared-host identities
|
|
200
|
+
are rejected rather than guessed. Codex delivery uses the recipient's Home.
|
|
201
|
+
|
|
202
|
+
Unconfirmed inbox messages are recoverable after a crash. A crash between output and
|
|
203
|
+
confirmation may repeat the same message ID; delivery does not mean the recipient has
|
|
204
|
+
read or accepted it. Turning off auto-wake also stops existing watchers from taking new
|
|
205
|
+
messages. Disabling Bridge blocks CLI send, rename and inbox operations; incomplete
|
|
206
|
+
integration removal returns an error and can be retried. See the guide for configuration
|
|
207
|
+
and delivery details, and the [unreleased changelog](./CHANGELOG.md#unreleased) for fixes.
|
|
208
|
+
|
|
160
209
|
## Commands
|
|
161
210
|
|
|
162
211
|
```bash
|
|
@@ -198,6 +247,32 @@ Commit the bilingual `docs/release-notes-vX.Y.Z.md` before tagging; follow the
|
|
|
198
247
|
|
|
199
248
|
## Agent integration
|
|
200
249
|
|
|
250
|
+
### JetBrains IDE terminal jump
|
|
251
|
+
|
|
252
|
+
Local Reworked terminals in IntelliJ-based IDEs 2026.2 / 2026.3 (IntelliJ IDEA,
|
|
253
|
+
PyCharm, WebStorm, GoLand, CLion, PhpStorm, RubyMine, Rider, etc.) support exact tab selection through
|
|
254
|
+
the **CC Pets Terminal** plugin. Open **Settings → General → Terminal Jump** in CC Pets:
|
|
255
|
+
each detected IDE has its own row, and **Install** writes the bundled plugin into that IDE's
|
|
256
|
+
plugin folder after you confirm. Restart the IDE if it was running, then open a project to
|
|
257
|
+
connect automatically; no port configuration is needed. When a newer plugin ships with
|
|
258
|
+
CC Pets, the row offers **Update**. IDEs with a customized plugin folder (`idea.plugins.path`)
|
|
259
|
+
fall back to **Settings → Plugins → ⚙ → Install Plugin from Disk**. Each IDE, stable and EAP
|
|
260
|
+
build keeps its own plugins. Classic and remote terminals are not supported yet.
|
|
261
|
+
See [plugin details](plugins/jetbrains/README.md) for installation and build instructions.
|
|
262
|
+
|
|
263
|
+
### VS Code terminal jump
|
|
264
|
+
|
|
265
|
+
VS Code 1.80+ and its forks (Cursor, Windsurf, VSCodium, Insiders, etc.) jump to the exact
|
|
266
|
+
integrated terminal — in the panel, a split or the editor area — through the **CC Pets Terminal**
|
|
267
|
+
extension. In **Settings → General → Terminal Jump**, each detected app has its own row;
|
|
268
|
+
**Install** runs that app's own command line tool with the bundled VSIX after you confirm.
|
|
269
|
+
Open windows usually connect on their own; otherwise run **Developer: Reload Window**. Apps
|
|
270
|
+
without a command line tool fall back to **Extensions → ⋯ → Install from VSIX…**. Without the
|
|
271
|
+
extension, a card only brings the app forward. Remote windows (SSH, WSL, containers) are not
|
|
272
|
+
supported. See [extension details](plugins/vscode/README.md).
|
|
273
|
+
|
|
274
|
+
### Codex and Claude hooks
|
|
275
|
+
|
|
201
276
|
Codex Hooks and Claude Code Hooks drive the pet's agent-state animations. After a
|
|
202
277
|
first installation or a Codex Hook update, start Codex and run `/hooks` to review
|
|
203
278
|
and trust the CC Pets Hook. Codex skips untrusted user hooks.
|
|
@@ -233,8 +308,7 @@ cc-pets open general # also: pet, accounts, alerts, diagnostics
|
|
|
233
308
|
```
|
|
234
309
|
|
|
235
310
|
<p align="center">
|
|
236
|
-
<img src="docs/images/main-menu-overview.en.png" width="
|
|
237
|
-
<img src="docs/images/main-menu-usage.en.png" width="45%" alt="Main menu Usage page with a 30-day daily chart stacked by model and a per-model table">
|
|
311
|
+
<img src="docs/images/main-menu-overview.en.png" width="48%" alt="Main menu Overview page with the pet, today's token usage and quota cards for each account"> <img src="docs/images/main-menu-usage.en.png" width="48%" alt="Main menu Usage page with a 30-day daily chart stacked by model and a per-model table">
|
|
238
312
|
</p>
|
|
239
313
|
|
|
240
314
|
- **Sidebar** — the current pet, animated, with its status, then two groups: **Workbench**
|
|
@@ -257,14 +331,14 @@ cc-pets open general # also: pet, accounts, alerts, diagnostics
|
|
|
257
331
|
an inbox and recent deliveries. Only who sent what to whom is shown, never the message.
|
|
258
332
|
- **Usage** — local Claude Code and Codex token usage for the last 7, 30 or 90 days. The same
|
|
259
333
|
five numbers as the overview lead the page: total usage (input + cache write + output +
|
|
260
|
-
cached input), input, output, cached input with its hit rate, and requests. The daily bar
|
|
334
|
+
cached input + background usage), input, output, cached input with its hit rate, and requests. Background usage from local Codex SQLite logs contributes to the total only, without an inferred token breakdown. The daily bar
|
|
261
335
|
chart stacks models in fixed colors and can switch between those five measures; click a model in the legend or the table to see only that
|
|
262
336
|
model, and hover a bar for that day's numbers. Everything is counted from local session
|
|
263
337
|
logs; nothing is sent anywhere. A per-day archive keeps history after Claude Code prunes
|
|
264
338
|
old transcripts.
|
|
265
339
|
- **Multi-Account** — add Claude / Codex Homes, view paths and integration status, and manage repairs, names, relocation and removal of custom Home integrations.
|
|
266
340
|
- **Pet / Alerts / Settings** — every pet setting, split into three short pages (Pet:
|
|
267
|
-
picker, size, chatter, click reactions and Codex import; Alerts: notifications, the status
|
|
341
|
+
picker, deletion of unselected custom pets with confirmation, size, chatter, click reactions and Codex import; Alerts: notifications, the status
|
|
268
342
|
card and system status; Settings: language, panel appearance and the pet sprites folder), plus finer controls such as the click-reaction thresholds and a
|
|
269
343
|
continuous glass dimming slider (the menu keeps its four presets). Changes apply to the
|
|
270
344
|
desktop pet immediately, and changes made in the menu show up here. Options that rewrite
|
|
@@ -274,7 +348,10 @@ cc-pets open general # also: pet, accounts, alerts, diagnostics
|
|
|
274
348
|
- **Diagnostics** — the same checks as `cc-pets doctor`, problems first: each with its area,
|
|
275
349
|
the suggested fix command and a copy button. Passing checks fold into one line. The PATH
|
|
276
350
|
order check only points you to `cc-pets doctor` in a terminal, since the pet's own PATH
|
|
277
|
-
isn't your terminal's.
|
|
351
|
+
isn't your terminal's. Version checks compare the local package, running binary and installed App;
|
|
352
|
+
source checkouts are labeled as a local source package, npm installations as a local npm package,
|
|
353
|
+
and unrecognized locations as a local package. These labels do not indicate publication on npm;
|
|
354
|
+
the update checker queries published versions separately.
|
|
278
355
|
**Re-check** and **Copy Report** (paths are shown as `~`, so it is safe to paste into an
|
|
279
356
|
issue). Registered accounts' Hooks and Claude status line issues offer **Auto-fix** and
|
|
280
357
|
**Fix All**. Configuration and affected scripts are backed up before changes, then checks
|
|
@@ -309,8 +386,7 @@ default. Changes apply immediately to the quota panel, status card, and speech
|
|
|
309
386
|
bubble, and persist across restarts. Liquid Glass uses native system glass and is
|
|
310
387
|
available on macOS 26 and later only. Building native glass support requires the
|
|
311
388
|
macOS 26 SDK or later. The same submenu has a **Glass dimming** setting for the quota
|
|
312
|
-
panel, status card, and speech bubble: Clear (0%), Light (
|
|
313
|
-
default), or Legible (45%). Lower levels
|
|
389
|
+
panel, status card, and speech bubble: Clear (0%), Light (25%), Standard (50%), or Legible (100%). Lower levels
|
|
314
390
|
look more transparent; higher levels keep text readable over light backgrounds.
|
|
315
391
|
|
|
316
392
|
### Language
|
|
@@ -373,8 +449,17 @@ Local seven-day quota history is disabled by default. When enabled, it is stored
|
|
|
373
449
|
only at `~/Library/Application Support/CC Pets/quota-history.json`, retains seven
|
|
374
450
|
days, and records at most once every 15 minutes.
|
|
375
451
|
|
|
452
|
+
In API usage mode, the monthly token trend shows today's usage and recorded days on
|
|
453
|
+
separate lines; hover over it for the selected account's peak usage. Codex exhaustion
|
|
454
|
+
markers expire five minutes after sampling, including when recovered from cache.
|
|
455
|
+
|
|
376
456
|
## Speech
|
|
377
457
|
|
|
458
|
+
Low-quota reminders track subscription accounts independently at 20%, 10% and 5%
|
|
459
|
+
remaining, name the triggering account, and queue during cooldown. Initial samples,
|
|
460
|
+
expired windows and API-usage accounts do not trigger reminders. General quota
|
|
461
|
+
placeholders use the subscription account with the least remaining quota.
|
|
462
|
+
|
|
378
463
|
The pet's speech comes from `~/.cc-pets/speech.txt`. Open **Chatter → Edit Lines…**
|
|
379
464
|
on the window's **Pet** page to edit, validate, preview, or restore it. Lines are grouped
|
|
380
465
|
under stable situation tags such as `[idle]`, `[done]`, and `[state_thinking]`.
|
|
@@ -451,6 +536,9 @@ external assets.
|
|
|
451
536
|
|
|
452
537
|
## Privacy
|
|
453
538
|
|
|
539
|
+
- Optional Shadowrocket launch protection (off by default) checks the local VPN state and sends HTTPS requests to the configured service’s `/cdn-cgi/trace` endpoint. The endpoint sees the connection’s exit IP; probes send no account credentials, verify TLS and do not follow redirects. See [Shadowrocket launch check](#shadowrocket-launch-check) for routing and support limits.
|
|
540
|
+
- Token accounting also reads local Codex SQLite logs and thread metadata, and keeps derived usage totals and incremental-read cursors in local caches; it does not upload those logs.
|
|
541
|
+
- Installed terminal extensions listen only on `127.0.0.1` and authenticate local requests. They store instance metadata and a local access token in `~/Library/Application Support/CC Pets/ide-instances/` with owner-only permissions. Extension installation writes to the selected IDE’s plugin/extension directory after confirmation; scripted terminal jumps require macOS Automation permission.
|
|
454
542
|
- Codex quota is read through the official Codex App Server started from your installed Codex CLI with its existing sign-in; Claude quota comes from the status line input Claude Code passes locally. Token counts are read from local Codex and Claude Code files.
|
|
455
543
|
- To tell API accounts from subscription accounts, CC Pets reads the authentication settings in each registered Home (Claude `settings.json`; Codex `auth.json` and `config.toml`) and may run that Home's `claude auth status` / `codex login status` locally. Only the resulting mode is kept, in memory; keys, emails and command output are not stored.
|
|
456
544
|
- Diagnostics repairs back up the affected configuration files and scripts to `~/Library/Application Support/CC Pets/diagnostic-backups/` (owner-only) before changing them; the backups stay on this Mac.
|
|
@@ -483,7 +571,10 @@ and restores the previous Claude status line. Other user settings and hooks rema
|
|
|
483
571
|
CC Pets is a community open-source project with no affiliation, authorization, or
|
|
484
572
|
official partnership with OpenAI, Anthropic, PetDex, or any character rights holder.
|
|
485
573
|
Codex, ChatGPT, Claude, their icons, and their trademarks belong to their respective
|
|
486
|
-
owners.
|
|
574
|
+
owners. When installed application icons are unavailable, CC Pets uses bundled Claude
|
|
575
|
+
and Codex fallback icons with normalized sizing. Their sources and separate ownership
|
|
576
|
+
are documented in [Third-party notices](./THIRD_PARTY_NOTICES.md); these icons are not
|
|
577
|
+
covered by the project's MIT License.
|
|
487
578
|
|
|
488
579
|
## License
|
|
489
580
|
|