Notch · 日迹

Mark every day. · 刻下每一天。

A local-first personal work journal with automatic activity tracking — it records the apps, window titles, and screenshots of your day, and turns them into AI summaries you can actually read.

一个本地优先的个人工作日志应用，带有自动活动追踪：记录你一天中用过的 App、窗口标题和截图，并生成你真正读得下去的 AI 总结。

Features · 功能特性

English

Quick notes — jot down thoughts and todos anytime.
Task timers — track when tasks start and stop.
AI summaries — auto-generated at 12:00 / 18:00 / 21:00 (requires ANTHROPIC_API_KEY).
Ask your day — a chat box that answers natural-language questions like "what did I do in the past hour?" (falls back to a time-windowed activity digest when no key is set).
Activity tracking (built into the server, macOS only):
- App usage time (real app names, aggregated by duration)
- Window-title tracking
- Screenshots (every 5 minutes)
- Pause / resume anytime
Local storage — one JSON file per day; syncs for free via iCloud/Dropbox.

中文

随手记 —— 随时记录想法和待办事项。
任务计时 —— 追踪任务的开始和结束时间。
AI 总结 —— 在 12:00 / 18:00 / 21:00 自动生成（需要 ANTHROPIC_API_KEY）。
问问今天 —— 对话框，支持自然语言提问，如「我过去一小时做了什么」（没 key 时按时间窗口返回活动汇总）。
活动追踪（内置于服务器，仅 macOS）：
- App 使用时间（真实 App 名，按时长聚合）
- 窗口标题追踪
- 截图（每 5 分钟）
- 可随时暂停 / 继续
本地存储 —— 每天一个 JSON 文件，支持 iCloud/Dropbox 同步。

Project structure · 项目结构

littlejot/
├── server/             # Node.js backend (with built-in tracking) · 后端（含内置追踪）
│   ├── index.js        # Express server + API + starts tracking · 服务器 + API + 启动追踪
│   ├── storage.js      # data storage · 数据存储
│   ├── tracker.js      # built-in activity tracker (osascript + screencapture) · 内置追踪
│   ├── summarizer.js   # AI summaries + Q&A · AI 总结与问答
│   └── scheduler.js    # scheduled summaries · 定时小结
├── public/
│   └── index.html      # frontend · 前端界面
├── src-tauri/          # (optional) Tauri desktop app · （可选）Tauri 桌面应用
│   └── ...
├── data/               # data directory · 数据目录
├── package.json
└── .env                # config · 环境配置

Getting started · 运行方式

Activity tracking is built into the Node server, so a single command runs the whole app — notes, timers, AI summaries, and app/window/screenshot tracking. No separate build or menu-bar app required.

活动追踪内置在 Node 服务器里，所以一条命令就能跑起整套应用——随手记、任务计时、AI 总结、App/窗口/截图追踪全部到位，不需要单独编译或启动菜单栏 App。

1. Start it (that's all) · 启动（这就是全部）

cd ~/Desktop/📁\ Projects/littlejot
npm start

Server runs at http://localhost:4174 with tracking on by default. 服务器运行在 http://localhost:4174，活动追踪默认开启。

2. Grant macOS permissions (first run) · 授权 macOS 权限（首次必做）

Tracking uses osascript and screencapture, so permissions go to whatever program runs node — usually your Terminal / iTerm, not a separate app:

追踪通过 osascript 和 screencapture 实现，权限要授予运行 node 的那个程序（通常是你的终端 / iTerm，而不是某个 App）：

Accessibility · 辅助功能: System Settings → Privacy & Security → Accessibility → enable your terminal. (Reads the foreground app name + window title · 读取前台 App 名称和窗口标题)
Screen Recording · 屏幕录制: System Settings → Privacy & Security → Screen Recording → enable your terminal. (For periodic screenshots · 用于定时截图)

It degrades gracefully without permissions: the server still runs and notes/timers/summaries all work — it just records no activity, and the UI shows the tracker as "受限（检查系统权限）".

没授权也不会崩溃：服务器照常运行，随手记/任务/总结都能用，只是不记录活动，界面会显示「受限（检查系统权限）」。

3. Pause / resume tracking · 暂停 / 继续追踪

The "暂停追踪 / 继续追踪" button at the top-right of the activity card, or
curl -X POST localhost:4174/api/tracker/toggle
To disable auto-tracking entirely, set TRACKING=off in .env.

网页活动卡片右上角的「暂停追踪 / 继续追踪」按钮；或上面的 curl 命令；想彻底关掉就在 .env 设 TRACKING=off。

4. (Optional) desktop app · （可选）桌面 App

The Tauri app in src-tauri/ opens Notch in a native window. Its old built-in tracker has been superseded by the server's tracking — don't run both at once or you'll get duplicate data. Stick to npm start.

src-tauri/ 下的 Tauri 桌面 App 会用原生窗口打开 Notch。它自带的旧追踪已被服务器内置追踪取代——两者别同时开，否则会重复记录。保持 npm start 这一条路径即可。

Deploy to the web (multi-user) · 部署到网上（多用户）

Notch ships in two modes. Locally it's the single-user app above. Set MULTIUSER=on and it becomes a public web app where every visitor gets their own private, cookie-scoped workspace — no login, no shared data. The default UI language is English (recruiters and first-time visitors land on English; the switcher still offers 中文 / 日本語 and the choice persists per browser).

In multi-user mode the macOS activity tracker and the scheduled summaries are turned off automatically (both only make sense for one local user), and the AI endpoints are rate-limited per visitor so a shared Anthropic key can't be abused (AI_PER_HOUR / AI_PER_MIN).

多用户模式下，每位访客都有自己独立的、由 Cookie 区分的工作区（无需登录、数据互不可见）。默认界面语言为英文，仍可切换到中文 / 日语并记住选择。macOS 活动追踪与定时总结会自动关闭， AI 接口按访客限流以保护共享的 API key。

One-click via Render Blueprint · 用 Render 一键部署

The repo includes render.yaml.

Push this repo to GitHub (already done if you're reading this on GitHub).
On Render: New + → Blueprint, pick this repo. Render reads render.yaml and provisions the web service in multi-user mode.
When prompted, set ANTHROPIC_API_KEY to your key (it's declared sync: false, so it lives only in Render, never in the repo). To run without AI, leave it blank — summaries/Q&A fall back to a deterministic digest.
Deploy. Your public URL is https://<service-name>.onrender.com.

Render's free tier has no persistent disk, so a visitor's data lives for their session and resets when the service restarts/redeploys — ideal for a demo. For durable storage, upgrade the instance and add a disk mounted at the path you point DATA_DIR to.

Any other Node host · 其它 Node 平台

Notch is a plain Node/Express server — it runs anywhere that runs Node 18+. Just set the environment and start it:

MULTIUSER=on TRACKING=off ANTHROPIC_API_KEY=sk-ant-... npm start

The host provides PORT; everything else has sane defaults.

API · API 端点

Endpoint	Method	Description	说明
`/api/today`	GET	Get all of today's data	获取今日所有数据
`/api/entries`	POST	Add a quick note	添加随手记
`/api/tasks/start`	POST	Start a task timer	开始任务
`/api/tasks/stop`	POST	Stop the current task	结束任务
`/api/summarize`	POST	Generate an AI summary	生成 AI 总结
`/api/ask`	POST	Conversational Q&A (`{question, history}`)	对话问答（基于当天数据+活动时间线）
`/api/activities/:date`	GET	Get a day's activity (apps/windows/screenshots)	获取某日活动
`/api/activities/status`	GET	Tracker status (running / current app / error)	内置追踪器状态
`/api/tracker/toggle`	POST	Pause / resume tracking (`{enabled}`)	暂停 / 继续追踪
`/api/activities/apps`	POST	(legacy) external app report	（兼容旧版）外部上报 App
`/api/activities/screenshots`	POST	(legacy) external screenshot upload	（兼容旧版）外部上传截图
`/api/activities/heartbeat`	POST	(legacy) external tracker heartbeat	（兼容旧版）外部追踪器心跳

Configuration (.env) · 环境配置

# Data directory · 数据存储目录
DATA_DIR=./data

# Port · 端口
PORT=4174

# Anthropic API key (optional; without it, summaries fall back to a plain digest)
# Anthropic API Key（可选，不填则用简单聚合总结）
ANTHROPIC_API_KEY=

# Claude model · Claude 模型
ANTHROPIC_MODEL=claude-sonnet-4-6

# Scheduled summary times · 自动总结时间
SUMMARY_SCHEDULE=12:00,18:00,21:00

# Activity tracking switch (off = no auto app/window/screenshot recording)
# 活动追踪开关（off = 不自动记录 App/窗口/截图）
TRACKING=on

Data format · 数据格式

One file per day at data/YYYY-MM-DD.json · 每日数据存储在 data/YYYY-MM-DD.json：

{
  "date": "2026-05-06",
  "entries": [{ "id", "ts", "text", "tag" }],
  "tasks": [{ "id", "name", "startTs", "endTs", "durationMs" }],
  "summaries": [{ "id", "ts", "slot", "text", "model" }],
  "activities": {
    "apps": [{ "id", "ts", "bundleId", "name", "durationMs" }],
    "windows": [{ "id", "ts", "app", "bundleId", "title", "durationMs" }],
    "screenshots": [{ "id", "ts", "filename" }]
  }
}

Screenshots are stored under data/screenshots/YYYY-MM-DD/. 截图文件存储在 data/screenshots/YYYY-MM-DD/ 目录。

Development · 开发

Rebuild the Tauri app · 重新编译 Tauri App：

cd ~/Desktop/📁\ Projects/littlejot
npm run tauri:build

Test the API · 测试 API：

node test-tracker.js

Status · 当前状态

Tech stack · 技术栈

Backend · 后端: Node.js + Express
Frontend · 前端: Vanilla JS + CSS
Activity tracking · 活动追踪: built into Node (osascript + screencapture, macOS only)
Desktop app (optional) · 桌面应用（可选）: Tauri v2 + Rust
Storage · 存储: local JSON files · 本地 JSON 文件
AI · 模型: Anthropic Claude Messages API (default claude-sonnet-4-6)

Navigation Menu

Repository files navigation

Notch · 日迹

Features · 功能特性

Project structure · 项目结构

Getting started · 运行方式

1. Start it (that's all) · 启动（这就是全部）

2. Grant macOS permissions (first run) · 授权 macOS 权限（首次必做）

3. Pause / resume tracking · 暂停 / 继续追踪

4. (Optional) desktop app · （可选）桌面 App

Deploy to the web (multi-user) · 部署到网上（多用户）

One-click via Render Blueprint · 用 Render 一键部署

Any other Node host · 其它 Node 平台

API · API 端点

Configuration (.env) · 环境配置

Data format · 数据格式

Development · 开发

Status · 当前状态

Tech stack · 技术栈

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
data		data
public		public
server		server
src-tauri		src-tauri
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
render.yaml		render.yaml
test-tracker.js		test-tracker.js

Latest commit

History

Folders and files

Repository files navigation

Notch · 日迹

Features · 功能特性

Project structure · 项目结构

Getting started · 运行方式

1. Start it (that's all) · 启动（这就是全部）

2. Grant macOS permissions (first run) · 授权 macOS 权限（首次必做）

3. Pause / resume tracking · 暂停 / 继续追踪

4. (Optional) desktop app · （可选）桌面 App

Deploy to the web (multi-user) · 部署到网上（多用户）

One-click via Render Blueprint · 用 Render 一键部署

Any other Node host · 其它 Node 平台

API · API 端点

Configuration (.env) · 环境配置

Data format · 数据格式

Development · 开发

Status · 当前状态

Tech stack · 技术栈

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages