Getnote Auth

Handles authentication for the Get笔记 (Biji.com) CLI so you can log in via OAuth or API key, check your auth status, and log out. The OAuth flow opens a browser and saves credentials automatically, while the API key method lets you paste a key directly if you prefer. Worth noting that it stores credentials in ~/.getnote/config.json, and there's a hierarchy where environment variables override saved config, and the --api-key flag gives you a one-off override without saving. Start with "getnote auth status" before running other commands to avoid auth errors.

skills.sh installs: 1.2K
GitHub stars: 179
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add iswalle/getnote-cli --skill getnote-auth --agent claude-code

Installs into .claude/skills of the current project.

Files

得到大脑连接、诊断与升级

负责把“用户想用得到大脑”推进到真正可执行的状态。不要只说“已安装”：CLI 可执行、账号已授权、API 可读三项都通过才算连接成功。

首次安装闭环

按顺序执行，已经满足的步骤直接跳过：

用 command -v getnote 检查 CLI；不要因为 Skill 已安装就假设 CLI 存在。独立的 ClawHub/OpenClaw Skill 由平台管理 CLI 依赖，不查找或运行 scripts/install.sh。
CLI 缺失时检查 node --version 和 npm --version，再自动执行 npm install -g @getnote/cli@latest。这是 Agent 的工作，不要求用户手工复制命令；只有系统弹出安装授权时才请用户确认。
执行 getnote version，必须能够正常启动。
执行 getnote auth status。未登录时运行 getnote auth login，让用户只在浏览器中确认，不索要 API Key、Cookie 或 Authorization。
执行 getnote doctor -o json。只有 diagnostics_completed=true、ready=true 且 status=ready，才能宣布完整连接；ready=true,status=degraded 表示核心能力可用但仍应处理警告。success 和旧 checks 字段仅用于兼容。若未就绪，先处理 issues[].blocking=true，再按 next_actions[] 修复。需要确认的动作不得静默执行。
在 Codex、Claude Code 或 Cursor 等本地 Agent 中，执行 getnote setup 同步 5 个领域 Skill；如果当前平台已经由独立 Skill 包携带这些领域 Skill，或 CLI 明确提示未检测到受支持平台，不把这一步失败误报成账号连接失败。
先用 getnote notes --limit 1 -o json 做无写入验收。只有用户同意创建测试内容时，才保存测试笔记。