# code-notch

**Repository Path**: fa0/code-notch

## Basic Information

- **Project Name**: code-notch
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-10
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CodeNotch

本地优先的 macOS 顶部 Dynamic Island 风格状态栏小窗。常驻顶栏、鼠标悬停展开,显示当前活跃的 coding agent 会话,点击跳回对应宿主(终端 tab 或 IDE)。

支持的 agent: **Claude Code CLI** / **Cursor IDE** / **OpenAI Codex**。对标 [Vibe Island](https://vibeisland.app/)。

## 仓库结构

```
.
├── CodeNotch/             # macOS app 源码
├── CodeNotch.xcodeproj/   # Xcode 工程
├── server/                # 远程推送 server (可选)
├── scripts/               # 打包 / 公证 / OTA 发布脚本
├── docs/                  # 技术文档
├── CLAUDE.md              # 项目架构 + 关键文件索引
└── AGENTS.md              # 代理工作流约定
```

仓库内两个独立组件:**macOS app** 是产品本体,**server** 是可选远端通道。

---

## macOS app

灵动岛风格的顶栏小窗,实时显示本机正在跑的 agent 会话(项目 / 最近 prompt / 状态 / 模型),点击跳回对应宿主。**单独使用即可,不依赖 server**。

文档入口:

- [`CLAUDE.md`](CLAUDE.md) —— 架构总览 & 关键文件
- [`docs/`](docs/) —— 状态检测、会话发现、rate-limit、OTA 发版

---

## 远程推送 server (可选)

让远端客户端实时查看 Mac 上正在跑的 agent 会话,代答 Claude / Codex 的问题与审批,并向终端注入回复文本。

支持的远端客户端:

- **浏览器 dashboard** (server 内置)
- **stdin REPL** (server 进程自身的命令行)
- **桌面摆件 / 小屏硬件** (如 ESP32 + LCD)

**默认 off**。启用与否不影响本地功能,默认状态下「本地优先,不引入远端服务」依然成立。

文档入口:

- [`server/README.md`](server/README.md) —— 入门 & 部署
- [`server/API.md`](server/API.md) —— 接口规格入口(总览 + 共享层),分 [`API-agent.md`](server/API-agent.md)(Mac 端)/ [`API-dashboard.md`](server/API-dashboard.md)(浏览器)两份