iswalle/getnote-cli
GitHub: iswalle/getnote-cli
Get笔记 CLI 是「得到大脑(Get笔记)的命令行工具,支持在终端和 AI Agent 中直接管理笔记、搜索内容、操作知识库。
Stars: 135 | Forks: 9
# 得到大脑(Get笔记) CLI
得到大脑(Get笔记)的命令行工具,让你在终端和 AI Agent 里直接管理笔记和知识库。
存链接、记文字、搜笔记、管知识库——一条命令搞定,支持脚本和 AI Agent 调用。
## 安装
npm install -g @getnote/cli
或者从 [Releases](https://github.com/iswalle/getnote-cli/releases) 下载对应平台的二进制文件,放到 `$PATH` 里。
## 三步开始用
**第一步:安装**
# 已完成,如上
**(可选)安装 AI Agent Skill**
在 Claude Code、Cursor 等 AI 编程工具里用自然语言操作笔记,需要额外安装 Skill:
npx skills add iswalle/getnote-cli -y -g
**第二步:登录**
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
## 典型使用场景
**场景 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 # 自动轮询,返回最终笔记
`skills/` 目录下有 Claude Code 专用的 Skill 文件,安装后 AI Agent 可以直接用自然语言操作笔记:
npx skills add iswalle/getnote-cli -y -g
安装后在 Claude Code / Cursor 里说「帮我搜一下关于 RAG 的笔记」即可直接调用。
## 完整命令参考
### 认证
getnote auth login OAuth 登录(浏览器授权)
getnote auth login --api-key --client-id 直接用 API Key 登录
getnote auth status 查看当前登录状态
getnote auth logout 退出登录
### 保存笔记
getnote save 保存链接/文字/图片笔记
--title <标题> 可选标题
--tag <标签> 标签(可重复)
getnote task 查看异步任务进度
链接笔记是异步处理的,CLI 会自动轮询等待完成,完成后直接展示内容。`-o json` 模式下静默轮询,返回最终笔记 JSON。
### 查看和管理笔记
getnote notes 最近 20 条笔记
--limit 自定义数量
--all 获取全部(自动翻页)
getnote note 笔记详情
--field <字段名> 只输出某个字段的值
(id/title/content/type/
created_at/url/excerpt)
getnote note update 更新笔记
--title <标题>
--content <内容> 仅文字笔记可用
--tag <标签> 逗号分隔,会替换现有标签
getnote note delete 删除笔记(移入回收站)
-y 跳过确认
### 搜索
getnote search <关键词> 全局语义搜索
--limit 返回数量(默认 10)
--kb 限定在某个知识库内搜索
### 标签
getnote tag add <标签> 给笔记加标签
getnote tag remove <标签> 删除笔记标签
getnote tag list 查看笔记的所有标签
### 知识库
getnote kbs 列出所有知识库
getnote kb 知识库内的笔记
--limit
--all 获取全部
getnote kb create <名称> 新建知识库
--desc <描述>
getnote kb add [note_id...] 加入知识库
getnote kb remove [note_id...] 移出知识库
getnote kb live-follow 订阅得到直播课,直播结束后 AI 摘要自动入库
getnote kbs-sub 获取我订阅的知识库列表
## 全局参数
| 参数 | 说明 |
|------|------|
| `--api-key ` | 临时覆盖 API Key |
| `-o, --output json\|table` | 输出格式(默认 table) |
| `--env prod\|dev` | 切换 API 环境 |
## 配置
凭证保存在 `~/.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 地址 |
## 从源码构建
需要 Go 1.21+。
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-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` 升级到最新版 | ## 相关链接 - [得到大脑(Get笔记)官网](https://biji.com) - [开放平台文档](https://www.biji.com/openapi) - [问题反馈](https://github.com/iswalle/getnote-cli/issues) ## License [MIT](https://opensource.org/licenses/MIT)
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` 升级到最新版 | ## 相关链接 - [得到大脑(Get笔记)官网](https://biji.com) - [开放平台文档](https://www.biji.com/openapi) - [问题反馈](https://github.com/iswalle/getnote-cli/issues) ## License [MIT](https://opensource.org/licenses/MIT)
标签:CLI, EVTX分析, Ruby, WiFi技术, 文档结构分析, 日志审计, 暗色界面, 生产力工具, 知识库, 笔记软件, 网络调试, 自动化