得到大脑（Get笔记） CLI

得到大脑（Get笔记）的命令行工具，让你在终端和 AI Agent 里直接管理笔记和知识库。

存链接、记文字、搜笔记、管知识库——一条命令搞定，支持脚本和 AI Agent 调用。

安装

让本地 AI 自动完成安装（推荐）

适用于 WorkBuddy、Codex、Claude Code 和 Cursor：

npx -y @getnote/cli@latest setup

这条命令会把 CLI 安装到稳定的全局路径、识别本机支持的平台、安装五个原子 Skill，并引导完成一次得到大脑授权。检测到 WorkBuddy 时，会把 Skills 安装到 ~/.workbuddy/skills/；安装完成后需要完全退出并重新打开 WorkBuddy。

如果只想安装到 WorkBuddy，可明确指定：

npx -y @getnote/cli@latest setup --target workbuddy

安装后运行：

getnote doctor -o json

安装完成后，getnote 和更短的 gnote 可以互换使用，例如 gnote notes。

只安装命令行

npm install -g @getnote/cli
getnote auth login

或者从 Releases 下载对应平台的二进制文件，放到 $PATH 里。

Windows 用户：推荐直接从 Releases 下载 .exe 文件，放到 PATH 里。用 npm install -g 安装时，如果遇到 Expand-Archive 相关报错，可尝试：

npm install -g @getnote/cli --ignore-scripts

然后手动从 Releases 下载对应平台的二进制文件。

使用要求

需要得到大脑（Get笔记）会员

OpenAPI（包括本 CLI 和 Skill）仅对得到大脑会员开放。未开通会员时执行命令会提示 OpenAPI 仅对会员开放。

开通会员：前往得到大脑会员购买页。

开始使用

如果已经单独安装 CLI，还可以为 Codex、Claude Code、Cursor 补装内置的五个原子 Skill：

npx skills add iswalle/getnote-cli -y -g

使用 getnote setup 时不需要再执行这条命令。

登录：

getnote auth login

会自动打开浏览器完成授权。也可以直接用 API Key（需同时传入 Client ID）：

getnote auth login --api-key gk_live_xxx --client-id cli_xxx

开始用：

# 存一篇文章
getnote save https://example.com/article --tag 阅读

# 记一条文字
getnote save "周五前要回复王总的邮件" --tag 待办

# 看最近的笔记
getnote notes

检查和升级

# 查看当前版本并检查是否有新版
getnote version --check-update

# 只检查，不安装
getnote update --check

# 升级到最新 GitHub Release
getnote update

如果通过 npm 安装，也可以完整更新 npm 包和可执行程序：

npm install -g @getnote/cli@latest

典型使用场景

场景 1：边看边存

# 存链接，自动抓取页面内容
getnote save https://simonwillison.net/2024/llms-reading-list/ --tag ai

# 存完自动展示笔记内容，不用再手动查

场景 2：搜索笔记

# 全局搜索
getnote search "LLM 推荐阅读"

# 在某个知识库内搜索
getnote search "产品设计" --kb vnrOAaGY

场景 3：管理知识库

# 列出所有知识库
getnote kbs

# 查看某个知识库的笔记
getnote kb vnrOAaGY --all

# 把笔记加入知识库
getnote kb add vnrOAaGY 1234567890

场景 4：脚本批处理

# 导出所有笔记为 JSON
getnote notes --all -o json > all-notes.json

# 取出某条笔记的正文
getnote note 1234567890 --field content | pbcopy

AI Agent 使用

所有命令支持 -o json 输出结构化数据，AI Agent 可以直接解析：

getnote notes -o json
getnote note 1234567890 -o json
getnote search "关键词" -o json
getnote save https://example.com -o json   # 自动轮询，返回最终笔记

保存、列表、详情和搜索的 JSON 结果都会返回当前环境可打开的 note_url。测试环境会返回测试站地址，生产环境返回 https://www.biji.com/note/{id}。

skills/ 目录是 CLI 内置的五个原子 Skill，也是本地 Agent 的唯一维护源。安装后 AI Agent 可以直接用自然语言操作笔记：

npx skills add iswalle/getnote-cli -y -g

安装后在 Claude Code / Cursor 里说「帮我搜一下关于 RAG 的笔记」即可直接调用。

独立的聚合 Skill 面向 WorkBuddy、QClaw 和 OpenClaw 生态，只负责意图理解，底层仍调用同一个 CLI，不再维护第二套 OpenAPI 请求实现。

完整命令参考

认证

getnote auth login                   OAuth 登录（浏览器授权）
getnote auth login --api-key <key> --client-id <id>  直接用 API Key 登录
getnote auth status                  查看当前登录状态
getnote auth logout                  退出登录
getnote doctor                       检查安装、登录和 API 连通性
getnote capabilities                 查看当前版本的稳定能力
getnote setup                        为本机 AI 安装原子 Skill 并引导授权

保存笔记

getnote save <url|文字|图片路径>      保存链接/文字/图片笔记
  --title <标题>                      可选标题
  --tag <标签>                        标签（可重复）
  --topic-id <topic_id>               直接存入普通/书籍/客户档案知识库
  --parent-id <note_id>               创建子笔记（ID 推荐传字符串）
  --idempotency-key <key>             同一创建请求重试时复用的幂等键
  --content-file <文件>               从 UTF-8 文件读取长文本，避免命令行转义和长度限制
  --stdin                              从标准输入读取长文本

getnote task <task_id>               查看异步任务进度

链接笔记是异步处理的，CLI 会自动轮询等待完成，完成后直接展示内容。-o json 模式下静默轮询，返回最终笔记 JSON。

查看和管理笔记

getnote notes                        最近 20 条笔记
  --limit <n>                        自定义数量
  --all                              获取全部（自动翻页）

getnote note <id>                    笔记详情
  --field <字段名>                   只输出某个字段的值
                                     （id/note_url/title/content/type/
                                       created_at/url/excerpt/
                                       web_content/audio_original）

getnote note original <id>           按笔记类型直接输出真实原文
getnote note transcript <id>         直接输出录音、会议或课堂转写原文
getnote note attachments <id>        列出图片、音频和文件附件
getnote note timeline <id>           读取录音或会议时间线
getnote note quick-note <id>         读取录音快捷笔记
getnote note todos <id>              读取会议总结中明确章节解析出的待办

getnote note update <id>             更新笔记
  --title <标题>
  --content <内容>                   仅文字笔记可用
  --tag <标签>                       逗号分隔，会替换现有标签

getnote note delete <id>             删除笔记（移入回收站）
  -y                                 跳过确认

getnote note share <id>              生成公开分享链接
  --exclude-audio                    分享时排除音频

字段语义说明（适合 AI Agent 参考）

不同笔记类型的"原文"字段不同，content 通常是 AI 总结而非原文：

笔记类型	原文字段	AI 总结字段
普通文字笔记	`content`	`content`
链接/网页笔记	`web_content`	`content`
录音笔记	`audio_original`	`content`
知识库博主内容	`post_media_text`（via `kb blogger-content`）	`content`
知识库直播	`post_media_text`（via `kb live`）	`post_summary`

AI Agent 提示：用户要求“读原文”时优先使用 getnote note original；明确要求录音、会议或课堂转写时使用 getnote note transcript，避免把 AI 摘要误当成原文。

搜索

getnote search <关键词>              全局语义搜索
  --limit <n>                        返回数量（默认 10）
  --kb <topic_id>                    限定在某个知识库内搜索

知识库

getnote kbs                          列出所有可访问知识库（DEFAULT / BOOKSPACE / CUSTOMER / TEAMSPACE）

getnote kb <topic_id>                知识库内的笔记
  --limit <n>
  --all                              获取全部
  --no-content                       JSON 输出时省略 content 字段（节省 AI token）

getnote kb create <名称>             新建知识库
  --desc <描述>

getnote kb add <topic_id> <note_id> [note_id...]     加入知识库
getnote kb add <topic_id> <note_id> --directory-id <id>  加入指定文件夹
getnote kb remove <topic_id> <note_id> [note_id...]  移出知识库
getnote kb directories <topic_id>                    浏览文件夹和资源
getnote kb directory-create <topic_id> <名称>        创建文件夹
getnote kb directory-update <topic_id> <id> --name <名称>  重命名或移动文件夹
getnote kb directory-delete <topic_id> <id> --yes    删除空文件夹
getnote kb blogger-follow <topic_id> <抖音链接>      订阅抖音博主
getnote kb live-follow <topic_id> <url>              订阅得到直播课，直播结束后 AI 摘要自动入库

getnote kbs-sub                                      获取我订阅的知识库列表

常用目录命令提供短别名，旧命令继续兼容：

gnote kb dir <topic_id>
gnote kb mkdir <topic_id> <名称>
gnote kb mvdir <topic_id> <directory_id> --name <新名称>
gnote kb rmdir <topic_id> <directory_id> --yes
gnote note quick <note_id>

全局参数

参数	说明
`--api-key <key>`	临时覆盖 API Key
`-o, --output json\|table`	输出格式（默认 table）

配置

凭证保存在 ~/.getnote/config.json：

{
  "api_key": "gk_live_xxx",
  "client_id": "cli_xxx"
}

也支持环境变量（优先级更高）：

变量	说明
`GETNOTE_API_KEY`	API Key
`GETNOTE_CLIENT_ID`	Client ID
`GETNOTE_API_URL`	覆盖 API 地址
`GETNOTE_WEB_URL`	覆盖笔记网页地址；通常无需设置，CLI 会随 API 环境自动选择

GETNOTE_API_URL 可传站点根地址、/open 或完整 /open/api/v1，业务请求和 OAuth 会同时使用该地址；未设置时仍使用生产环境。

新版 API 兼容约定

note_id、parent_note_id、children_ids、cursor 等雪花 ID 按字符串无损输出；历史 id / next_cursor 数字字段继续保留。
HTTP 200 且 success:false 仍按失败处理并返回非零退出码；错误保留 code/reason/retryable/field/constraint/expected_type/request_id。
getnote save --idempotency-key 用于防止网络重试产生重复笔记；同一请求必须复用同一个键。

从源码构建

需要 Go 1.24.2+。

git clone https://github.com/iswalle/getnote-cli.git
cd getnote-cli
make install

🚀 进阶用法：用笔记内链实践柳比歇夫时间日志法

柳比歇夫时间日志法的核心是每天记录自己把时间花在了哪里，事后统计、复盘、改进。

结合得到大脑（Get笔记）内链，可以用脚本自动串联：

# 每天早上新建当天日志，内链到关联项目笔记
$ getnote save "今天工作日志 - 以下是进展：\n参考：biji.com/note/{note_id}" --tag 日志

# 每周查看本周日志，复盘时间分配
$ getnote search "工作日志" --limit 7 -o json

内链格式：在笔记正文里用 https://biji.com/note/{note_id} 引用其他笔记。示例：

参考上次的讨论：https://biji.com/note/1234567890000000001

🆕 更新日志

日期	版本	新能力	适合怎么用
2026-08-14	v1.5.2	1. 补齐团队知识库、订阅知识库与文件夹操作的执行边界 2. 明确目录、资源及笔记 ID 的结构化结果字段，避免 AI 猜字段 3. 搜索结果按字符串 `note_id` 去重，不把同一笔记的多个命中片段重复展示 4. 完善“这条笔记”、录音分享与权限失败的安全处理	提升 CLI 内置 Skills 在知识库整理、搜索和笔记管理场景中的理解与执行准确度；本次不改变既有 CLI 命令和授权凭证
2026-08-13	v1.5.1	1. 修复通过 `npx setup` 安装后命令指向临时 npm 缓存的问题 2. 同时提供稳定的 `getnote` / `gnote` 双命令 3. 自动把五个领域 Skill 安装到 WorkBuddy 4. 重复安装保留已有授权凭证	在 WorkBuddy、Codex、Claude Code 或 Cursor 中重复执行同一条安装命令即可修复或升级，不需要重新授权
2026-08-13	v1.5.0	1. 支持浏览、创建、移动和删除知识库目录 2. 笔记可直接加入指定目录，支持已有团队知识库 `TEAMSPACE` 的成员读取与管理员维护 3. 支持订阅抖音博主并读取博主内容 4. 新增录音原文、链接原文、附件、时间线、快捷笔记和会议待办等一级命令 5. 完善结构化结果、错误原因、短命令、`doctor` 和升级检查	让人和 AI 用同一套命令完成知识库整理、资料归档和深层笔记读取；失败时能识别原因，不再猜参数或把未完成任务当成成功
2026-08-11	v1.4.0	1. Skill 2.0 稳定执行契约 2. 所有子命令完整 `-h` / `--help` 3. `getnote update --check` 与升级引导 4. `--content-file` / `--stdin` 安全保存长文本	让独立 Skill 和 CLI 内置原子 Skills 共用同一套真实命令，降低 AI 猜参数和长内容转义失败的概率
2026-04-23	v1.1.1	1. 笔记内链 2. 保存分享链接自动变笔记	1. 用内链串联每天的工作日志和项目笔记，实践时间日志法 2. 收到别人发来的分享链接直接存入笔记
2026-04-16	v1.1.0	1. `getnote note share`：生成分享链接 2. `getnote kb live-follow`：订阅得到直播	1. 把笔记一键分享给朋友 2. 在知识库里订阅得到直播课，直播结束后 AI 摘要自动入库
2026-04-03	v1.0.x	1. `getnote kb bloggers/lives`：查看博主和直播列表 2. `getnote update`：自动升级	1. 查看订阅博主的内容更新和直播摘要 2. 直接运行 `getnote update` 升级到最新版

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 131 Commits
.github/workflows		.github/workflows
bin		bin
cmd		cmd
internal		internal
scripts		scripts
skills		skills
.gitignore		.gitignore
.npmrc		.npmrc
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
getnote-cli		getnote-cli
go.mod		go.mod
go.sum		go.sum
main.go		main.go
package.json		package.json

Navigation Menu

Repository files navigation

得到大脑（Get笔记） CLI

安装

让本地 AI 自动完成安装（推荐）

只安装命令行

使用要求

开始使用

检查和升级

典型使用场景

AI Agent 使用

完整命令参考

认证

保存笔记

查看和管理笔记

字段语义说明（适合 AI Agent 参考）

搜索

标签

知识库

全局参数

配置

新版 API 兼容约定

从源码构建

🚀 进阶用法：用笔记内链实践柳比歇夫时间日志法

🆕 更新日志

相关链接

License

About

Releases

Packages

Used by

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

得到大脑（Get笔记） CLI

安装

让本地 AI 自动完成安装（推荐）

只安装命令行

使用要求

开始使用

检查和升级

典型使用场景

AI Agent 使用

完整命令参考

认证

保存笔记

查看和管理笔记

字段语义说明（适合 AI Agent 参考）

搜索

标签

知识库

全局参数

配置

新版 API 兼容约定

从源码构建

🚀 进阶用法：用笔记内链实践柳比歇夫时间日志法

🆕 更新日志

相关链接

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages