JSPM

@toolittlecakes/granola-cli

0.2.2
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 27
  • Score
    100M100P100Q86723F
  • License MIT

JSON-first CLI for the official Granola Public API.

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@toolittlecakes/granola-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    granola-cli

    JSON-first CLI for the official Granola Public API.

    Install

    Before npm publication:

    npm install -g git+https://github.com/toolittlecakes/granola-cli.git

    After npm publication:

    npm install -g @toolittlecakes/granola-cli@latest

    Auth

    Create a Granola API key in the desktop app: Settings -> Connectors -> API keys. Then save it once:

    granola-cli auth <token>

    The token is stored in ~/.granola-cli/config.json with file mode 0600 where supported. The CLI does not read ~/.env and never prints the token.

    Check auth state:

    granola-cli auth status

    Clear auth:

    granola-cli auth clear

    Commands

    granola-cli status
granola-cli folders list --all --json
granola-cli folders resolve itquick --json
granola-cli notes list --folder itquick --all --jsonl
granola-cli notes get not_... --include transcript --json
granola-cli notes summary not_... --format markdown
granola-cli notes transcript not_... --format markdown
granola-cli export folder itquick --out calls/granola_itquick --include summary,transcript --skip-existing

    Agent Skill

    The version-matched guide is bundled into the CLI:

    granola-cli skill

    Install the thin discovery skill:

    granola-cli setup --agents codex,claude

    Update Gate

    When distributed through npm, granola-cli checks @toolittlecakes/granola-cli@latest before running commands. If a newer version exists, it exits and asks you to update.

    For one local/dev command:

    granola-cli --skip-updates status

    Before npm publication, GitHub installs should use --skip-updates because the npm registry entry may not exist yet.

    API Surface

    This tool uses only documented Granola Public API endpoints:

    • GET /v1/folders
    • GET /v1/notes
    • GET /v1/notes/{note_id}

    Base URL: https://public-api.granola.ai/v1.