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)
标签:CLI, EVTX分析, Ruby, WiFi技术, 文档结构分析, 日志审计, 暗色界面, 生产力工具, 知识库, 笔记软件, 网络调试, 自动化