Gran 👵🏻

Local-first workspace for your Granola archive.

Sync your meetings locally, browse them in the browser or terminal, and publish them into folders or Obsidian vaults you own.

Install

npm install -g @kkarimi/gran
gran --help

Without a global install:

npx @kkarimi/gran --help

If you want the SDK instead of the CLI:

npm install @kkarimi/gran-sdk

If you do not want to install via npm, each GitHub release also publishes standalone archives for macOS arm64, Linux x64, and Windows x64. Extract the archive and run gran (or gran.exe on Windows).

Start

gran init

Documentation

The full docs live at kkarimi.github.io/gran.

Start with:

• Overview
• Getting started
• Workflows and examples
• Exporting
• Integrations
• SDK
• Auth and configuration

Release history is also tracked in CHANGELOG.md.

Contributing

Contributions are welcome. See CONTRIBUTING.md for local setup, QA expectations, and contribution workflow.

Local Development

curl -fsSL https://vite.plus | bash
vp install
npm run docs:check
vp pack
node dist/cli.js --help