granola-toolkit 0.66.0 → 0.67.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nima Karimi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,34 @@
 # granola-toolkit
 
-Toolkit for working with Granola meetings, notes, transcripts, folders, and local workspaces.
+[![npm version](https://img.shields.io/npm/v/granola-toolkit?label=npm)](https://www.npmjs.com/package/granola-toolkit)
+[![CI](https://img.shields.io/github/actions/workflow/status/kkarimi/granola-toolkit/ci.yml?branch=main&label=ci)](https://github.com/kkarimi/granola-toolkit/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-live-0f766e)](https://kkarimi.github.io/granola-toolkit/)
+[![License](https://img.shields.io/github/license/kkarimi/granola-toolkit)](https://github.com/kkarimi/granola-toolkit/blob/main/LICENSE)
+
+The unofficial open-source Swiss army knife for Granola.
+
+Sync your meeting archive locally, browse it in the browser or terminal, export anything you need,
+and run your own agents against transcripts and notes.
+
+> `granola-toolkit` is for people who want more than a flat export command:
+> a local-first Granola archive, a real browser and terminal workspace, and automation you control.
+
+## Why Use It
+
+- Local-first control instead of being trapped in one app surface
+- CLI, browser, and TUI on one shared runtime and one local index
+- Bring your own agent workflows on top of transcripts and notes
+- Export notes and transcripts into files you actually own
+- Open-source and scriptable, with local prompts, rules, skills, and plugins
+
+## What You Get
+
+- `granola sync` for local indexing and refresh
+- `granola web` for a browser workspace
+- `granola tui` / `granola attach` for keyboard-first terminal use
+- `granola notes` and `granola transcripts` for file exports
+- `granola automation` plus harnesses/rules for BYOA review workflows
+- local diagnostics, sync history, and inspectable runtime state
 
 ## Install
 
@@ -47,6 +75,44 @@ opening a browser first.
 If you prefer to reuse the desktop app session instead, `granola auth login` still imports it from
 `supabase.json`.
 
+## Set Default Configuration
+
+`granola init` writes a project-local `.granola.toml` for you. If you want to edit it directly,
+the file can look like this:
+
+```toml
+agent-provider = "openrouter"
+agent-model = "openai/gpt-5-mini"
+agent-harnesses-file = "./.granola/agent-harnesses.json"
+automation-rules-file = "./.granola/automation-rules.json"
+pkm-targets-file = "./.granola/pkm-targets.json"
+output = "./exports/notes"
+transcript-output = "./exports/transcripts"
+debug = false
+```
+
+The CLI reads configuration in this order:
+
+1. command-line flags
+2. environment variables
+3. `.granola.toml`
+4. platform defaults
+
+Relative paths in `.granola.toml` resolve from the directory that contains the config file.
+
+## Debug Logging
+
+Yes, the toolkit supports a real debug mode.
+
+```bash
+granola sync --debug
+granola web --debug --foreground
+DEBUG_MODE=1 granola service start
+```
+
+Useful when you want to see config resolution, auth mode selection, sync behaviour, and runtime
+paths while diagnosing local-state issues.
+
 ## Documentation
 
 The detailed documentation now lives at
@@ -63,16 +129,24 @@ Key docs entry points:
 
 - [`Overview`](https://kkarimi.github.io/granola-toolkit/docs/)
 - [`Getting Started`](https://kkarimi.github.io/granola-toolkit/docs/getting-started/)
-- [`Exporting`](https://kkarimi.github.io/granola-toolkit/docs/exporting/)
-- [`Meetings and Folders`](https://kkarimi.github.io/granola-toolkit/docs/meetings-and-folders/)
+- [`Automation`](https://kkarimi.github.io/granola-toolkit/docs/automation/)
 - [`Server, Web, and TUI`](https://kkarimi.github.io/granola-toolkit/docs/server-web-and-tui/)
 - [`Auth and Configuration`](https://kkarimi.github.io/granola-toolkit/docs/auth-and-configuration/)
-- [`Development`](https://kkarimi.github.io/granola-toolkit/docs/development/)
+- [`Exporting`](https://kkarimi.github.io/granola-toolkit/docs/exporting/)
+- [`Meetings and Folders`](https://kkarimi.github.io/granola-toolkit/docs/meetings-and-folders/)
+- [`Agent Skills`](https://kkarimi.github.io/granola-toolkit/docs/agent-skills/)
+- [`Architecture`](https://kkarimi.github.io/granola-toolkit/docs/architecture/)
 - [`Releases`](https://kkarimi.github.io/granola-toolkit/docs/releases/)
+- [`Development`](https://kkarimi.github.io/granola-toolkit/docs/development/)
 
 Release history is also tracked in
 [`CHANGELOG.md`](https://github.com/kkarimi/granola-toolkit/blob/main/CHANGELOG.md).
 
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](/Users/nima/dev/personal/granola-cli/CONTRIBUTING.md) for
+local setup, QA expectations, and contribution workflow.
+
 ## Local Development
 
 ```bash