Getnote Auth
- 1k installs
- 165 repo stars
- Updated July 27, 2026
- iswalle/getnote-cli
getnote-auth is a CLI skill that manages GetNote CLI login, logout, and credential status for developers who sync Get笔记 notes inside Cursor or Claude Code sessions.
About
getnote-auth is version 0.4.0 of the authentication skill for the GetNote CLI from iswalle/getnote-cli. It guides developers through OAuth browser login or direct API-key login with commands like getnote auth login and getnote auth login --api-key, then persists credentials for subsequent pull and sync operations. Developers reach for getnote-auth when setting up GetNote inside Cursor or Claude Code, rotating keys from https://www.biji.com/settings/developer, or verifying whether a session is already authenticated before running note commands. The skill covers login, logout, and status checks only; it does not replace downstream sync or export skills. API keys use the gk_live_ prefix format documented in the skill readme.
- Three core commands: login, status, and logout
- OAuth flow that opens browser for authorization
- Direct API key support with --api-key flag
- Always-run status check before other GetNote commands
- Credential storage in ~/.getnote/config.json with env var overrides
Getnote Auth by the numbers
- 1,011 all-time installs (skills.sh)
- +30 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #1,040 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/iswalle/getnote-cli --skill getnote-authAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1k |
|---|---|
| repo stars | ★ 165 |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 27, 2026 |
| Repository | iswalle/getnote-cli ↗ |
How do you authenticate the GetNote CLI?
Securely authenticate the GetNote CLI before pulling or syncing notes inside Cursor or Claude Code sessions.
Who is it for?
Developers integrating Get笔记 notes into agent workflows who need a quick, documented OAuth or API-key setup for the GetNote CLI.
Skip if: Teams that do not use GetNote or only need generic note-taking without the GetNote CLI should skip getnote-auth entirely.
When should I use this skill?
A developer mentions GetNote login, API keys, auth status, or cannot sync notes because the CLI is unauthenticated.
What you get
Saved GetNote OAuth or API-key credentials, confirmed auth status, and a CLI ready for note pull or sync commands.
- Authenticated CLI session
- Stored OAuth or API-key credentials
By the numbers
- Skill version 0.4.0 documented in the readme frontmatter
Files
getnote-auth Skill
Log in, log out, and check authentication status.
Commands
Log in
getnote auth login [--api-key <key>]| Mode | Command | Description |
|---|---|---|
| OAuth (recommended) | getnote auth login | Opens browser to authorize; saves credentials automatically |
| API Key | getnote auth login --api-key <key> | Saves key directly, no browser needed |
# OAuth flow (opens browser)
getnote auth login
# API key directly
getnote auth login --api-key gk_live_xxxGet your API key at: https://www.biji.com/settings/developer (keys start with gk_live_)
---
Check status
getnote auth statusShows whether authenticated and which API key is active.
getnote auth status---
Log out
getnote auth logoutRemoves saved credentials from ~/.getnote/config.json.
getnote auth logout---
Agent Usage Notes
- Always run
getnote auth statusfirst to verify authentication before other commands. - If not authenticated, prompt the user to run
getnote auth login. --api-keyon any command is a temporary per-invocation override and does not save credentials.- Credentials saved at
~/.getnote/config.json; env varsGETNOTE_API_KEY/GETNOTE_CLIENT_IDtake higher priority.
Related skills
Setup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196k
Lark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402k
CavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7k
Lark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16k
Running Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72
Codex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10FAQ
How does getnote-auth log in with OAuth?
getnote-auth runs getnote auth login, which opens a browser for authorization and saves credentials automatically. This OAuth mode is the recommended path in the version 0.4.0 skill readme.
Where do GetNote API keys come from?
getnote-auth directs developers to https://www.biji.com/settings/developer for API keys that start with gk_live_. Pass the key with getnote auth login --api-key without opening a browser.
Is Getnote Auth safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.