{"id":47738477,"url":"https://github.com/iswalle/getnote-cli","last_synced_at":"2026-04-23T12:01:10.077Z","repository":{"id":348673639,"uuid":"1194330811","full_name":"iswalle/getnote-cli","owner":"iswalle","description":"Get笔记 CLI — 让人类和 AI Agent 都能在终端操作 Get笔记","archived":false,"fork":false,"pushed_at":"2026-04-23T10:33:52.000Z","size":24109,"stargazers_count":32,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-23T11:26:48.778Z","etag":null,"topics":["cli","getnote","note-taking"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iswalle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-28T07:50:30.000Z","updated_at":"2026-04-23T10:33:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/iswalle/getnote-cli","commit_stats":null,"previous_names":["iswalle/getnote-cli"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/iswalle/getnote-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iswalle%2Fgetnote-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iswalle%2Fgetnote-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iswalle%2Fgetnote-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iswalle%2Fgetnote-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iswalle","download_url":"https://codeload.github.com/iswalle/getnote-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iswalle%2Fgetnote-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32179387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T11:42:27.955Z","status":"ssl_error","status_checked_at":"2026-04-23T11:42:18.877Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","getnote","note-taking"],"created_at":"2026-04-02T23:10:45.267Z","updated_at":"2026-04-23T12:01:10.069Z","avatar_url":"https://github.com/iswalle.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Get笔记 CLI\n\nGet笔记的命令行工具，让你在终端和 AI Agent 里直接管理笔记和知识库。\n\n存链接、记文字、搜笔记、管知识库——一条命令搞定，支持脚本和 AI Agent 调用。\n\n---\n\n## 安装\n\n```bash\nnpm install -g @getnote/cli\n```\n\n或者从 [Releases](https://github.com/iswalle/getnote-cli/releases) 下载对应平台的二进制文件，放到 `$PATH` 里。\n\n---\n\n## 三步开始用\n\n**第一步：安装**\n```bash\nnpm install -g @getnote/cli\n```\n\n**（可选）安装 AI Agent Skill**\n\n在 Claude Code、Cursor 等 AI 编程工具里用自然语言操作笔记，需要额外安装 Skill：\n```bash\nnpx skills add iswalle/getnote-cli -y -g\n```\n\n\u003e ⚠️ 需先完成第一步安装 CLI，再安装 Skill。\n\n**第二步：登录**\n```bash\ngetnote auth login\n```\n会自动打开浏览器完成授权。也可以直接用 API Key：\n```bash\ngetnote auth login --api-key gk_live_xxx\n```\n\n**第三步：开始用**\n```bash\n# 存一篇文章\ngetnote save https://example.com/article --tag 阅读\n\n# 记一条文字\ngetnote save \"周五前要回复王总的邮件\" --tag 待办\n\n# 看最近的笔记\ngetnote notes\n```\n\n---\n\n## 典型使用场景\n\n**场景 1：边看边存**\n```bash\n# 存链接，自动抓取页面内容\ngetnote save https://simonwillison.net/2024/llms-reading-list/ --tag ai\n\n# 存完自动展示笔记内容，不用再手动查\n```\n\n**场景 2：搜索笔记**\n```bash\n# 全局搜索\ngetnote search \"LLM 推荐阅读\"\n\n# 在某个知识库内搜索\ngetnote search \"产品设计\" --kb vnrOAaGY\n```\n\n**场景 3：管理知识库**\n```bash\n# 列出所有知识库\ngetnote kbs\n\n# 查看某个知识库的笔记\ngetnote kb vnrOAaGY --all\n\n# 把笔记加入知识库\ngetnote kb add vnrOAaGY 1234567890\n```\n\n**场景 4：脚本批处理**\n```bash\n# 导出所有笔记为 JSON\ngetnote notes --all -o json \u003e all-notes.json\n\n# 取出某条笔记的正文\ngetnote note 1234567890 --field content | pbcopy\n```\n\n---\n\n## AI Agent 使用\n\n所有命令支持 `-o json` 输出结构化数据，AI Agent 可以直接解析：\n\n```bash\ngetnote notes -o json\ngetnote note 1234567890 -o json\ngetnote search \"关键词\" -o json\ngetnote save https://example.com -o json   # 自动轮询，返回最终笔记\n```\n\n`skills/` 目录下有 Claude Code 专用的 Skill 文件，安装后 AI Agent 可以直接用自然语言操作笔记：\n\n```bash\nnpx skills add iswalle/getnote-cli -y -g\n```\n\n安装后在 Claude Code / Cursor 里说「帮我搜一下关于 RAG 的笔记」即可直接调用。\n\n---\n\n## 完整命令参考\n\n### 认证\n\n```\ngetnote auth login                   OAuth 登录（浏览器授权）\ngetnote auth login --api-key \u003ckey\u003e   直接用 API Key 登录\ngetnote auth status                  查看当前登录状态\ngetnote auth logout                  退出登录\n```\n\n### 保存笔记\n\n```\ngetnote save \u003curl|文字|图片路径\u003e      保存链接/文字/图片笔记\n  --title \u003c标题\u003e                      可选标题\n  --tag \u003c标签\u003e                        标签（可重复）\n\ngetnote task \u003ctask_id\u003e               查看异步任务进度\n```\n\n链接笔记是异步处理的，CLI 会自动轮询等待完成，完成后直接展示内容。`-o json` 模式下静默轮询，返回最终笔记 JSON。\n\n### 查看和管理笔记\n\n```\ngetnote notes                        最近 20 条笔记\n  --limit \u003cn\u003e                        自定义数量\n  --all                              获取全部（自动翻页）\n\ngetnote note \u003cid\u003e                    笔记详情\n  --field \u003c字段名\u003e                   只输出某个字段的值\n                                     （id/title/content/type/\n                                       created_at/url/excerpt）\n\ngetnote note update \u003cid\u003e             更新笔记\n  --title \u003c标题\u003e\n  --content \u003c内容\u003e                   仅文字笔记可用\n  --tag \u003c标签\u003e                       逗号分隔，会替换现有标签\n\ngetnote note delete \u003cid\u003e             删除笔记（移入回收站）\n  -y                                 跳过确认\n```\n\n### 搜索\n\n```\ngetnote search \u003c关键词\u003e              全局语义搜索\n  --limit \u003cn\u003e                        返回数量（默认 10）\n  --kb \u003ctopic_id\u003e                    限定在某个知识库内搜索\n```\n\n### 标签\n\n```\ngetnote tag add \u003cnote_id\u003e \u003c标签\u003e     给笔记加标签\ngetnote tag remove \u003cnote_id\u003e \u003c标签\u003e  删除笔记标签\ngetnote tag list \u003cnote_id\u003e           查看笔记的所有标签\n```\n\n### 知识库\n\n```\ngetnote kbs                          列出所有知识库\n\ngetnote kb \u003ctopic_id\u003e                知识库内的笔记\n  --limit \u003cn\u003e\n  --all                              获取全部\n\ngetnote kb create \u003c名称\u003e             新建知识库\n  --desc \u003c描述\u003e\n\ngetnote kb add \u003ctopic_id\u003e \u003cnote_id\u003e [note_id...]     加入知识库\ngetnote kb remove \u003ctopic_id\u003e \u003cnote_id\u003e [note_id...]  移出知识库\n```\n\n---\n\n## 全局参数\n\n| 参数 | 说明 |\n|------|------|\n| `--api-key \u003ckey\u003e` | 临时覆盖 API Key |\n| `-o, --output json\\|table` | 输出格式（默认 table） |\n| `--env prod\\|dev` | 切换 API 环境 |\n\n---\n\n## 配置\n\n凭证保存在 `~/.getnote/config.json`：\n\n```json\n{\n  \"api_key\": \"gk_live_xxx\",\n  \"client_id\": \"cli_xxx\"\n}\n```\n\n也支持环境变量（优先级更高）：\n\n| 变量 | 说明 |\n|------|------|\n| `GETNOTE_API_KEY` | API Key |\n| `GETNOTE_CLIENT_ID` | Client ID |\n| `GETNOTE_API_URL` | 覆盖 API 地址 |\n\n---\n\n## 从源码构建\n\n需要 Go 1.21+。\n\n```bash\ngit clone https://github.com/iswalle/getnote-cli.git\ncd getnote-cli\nmake install\n```\n\n---\n\n## 相关链接\n\n- [Get笔记官网](https://biji.com)\n- [开放平台文档](https://openapi.biji.com/docs)\n- [问题反馈](https://github.com/iswalle/getnote-cli/issues)\n\n## License\n\n[MIT](https://opensource.org/licenses/MIT)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiswalle%2Fgetnote-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiswalle%2Fgetnote-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiswalle%2Fgetnote-cli/lists"}