granola-cli 0.1.0 → 0.2.0

package/README.md

@@ -1,5 +1,10 @@
 # Granola CLI
 
+[![npm version](https://img.shields.io/npm/v/granola-cli.svg)](https://www.npmjs.com/package/granola-cli)
+[![npm downloads](https://img.shields.io/npm/dm/granola-cli.svg)](https://www.npmjs.com/package/granola-cli)
+[![license](https://img.shields.io/npm/l/granola-cli.svg)](https://github.com/magarcia/granola-cli/blob/main/LICENSE)
+[![CI](https://github.com/magarcia/granola-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/magarcia/granola-cli/actions/workflows/ci.yml)
+
 > [!IMPORTANT]
 > **Disclaimer**: This is an **unofficial, open-source community project** and is **not affiliated with, endorsed by, or connected to Granola Labs, Inc.** (the company behind [Granola.ai](https://www.granola.ai/)). Granola is a registered trademark of Granola Labs, Inc. This CLI is an independent tool that uses the publicly available Granola API to provide command-line access to your own meeting data.
 
@@ -119,11 +124,23 @@ granola meeting list [options]
 |--------|-------------|
 | `-l, --limit <n>` | Number of meetings to show (default: 20) |
 | `-w, --workspace <id>` | Filter by workspace ID |
-| `-f, --folder <id>` | Filter by folder ID (requires folder support; the CLI warns if folders are unavailable) |
+| `-f, --folder <id>` | Filter by folder ID |
+| `-s, --search <query>` | Search in meeting titles (case-insensitive) |
+| `-a, --attendee <name>` | Filter by attendee name or email (partial match) |
+| `-d, --date <date>` | Filter meetings on a specific date |
+| `--since <date>` | Filter meetings from date (inclusive) |
+| `--until <date>` | Filter meetings up to date (inclusive) |
 
-**Example:**
+**Date formats supported:**
+- Keywords: `today`, `yesterday`, `tomorrow`
+- Relative: `3 days ago`, `2 weeks ago`, `last week`, `last month`
+- ISO: `2024-12-20`, `2024/12/20`
+- Simple: `Dec 20`, `Dec 20 2024`, `20 Dec`
+
+**Examples:**
 
 ```bash
+# Basic listing
 $ granola meeting list --limit 5
 
 Showing 5 meetings
@@ -132,6 +149,24 @@ ID          TITLE                           DATE
 a1b2c3d4    Q4 Planning Session             Dec 18, 2025
 e5f6g7h8    1:1 with Sarah                  Dec 18, 2025
 i9j0k1l2    Sprint Retrospective            Dec 17, 2025
+
+# Search by title
+$ granola meeting list --search "planning"
+
+# Filter by attendee
+$ granola meeting list --attendee john
+
+# Filter by date
+$ granola meeting list --date today
+$ granola meeting list --date yesterday
+$ granola meeting list --date "Dec 20"
+
+# Filter by date range
+$ granola meeting list --since "last week"
+$ granola meeting list --since 2024-12-01 --until 2024-12-15
+
+# Combine filters
+$ granola meeting list --search standup --attendee john --since yesterday
 ```
 
 #### View meeting details
@@ -583,7 +618,6 @@ DEBUG=granola:cli:* granola meetings
 | ------------------- | ---------------------------- |
 | `granola:cli`       | CLI entry point, startup     |
 | `granola:cli:alias` | Alias expansion              |
-| `granola:cli:subcommand` | External subcommand discovery |
 | `granola:service:*` | All service layer operations |
 | `granola:lib:*`     | All library utilities        |
 | `granola:cmd:*`     | All command handlers         |
@@ -603,7 +637,19 @@ DEBUG=granola:cli:* granola meetings
 
 ```bash
 # See today's meetings
-granola meeting list --limit 5
+granola meeting list --date today
+
+# See yesterday's meetings
+granola meeting list --date yesterday
+
+# Find meetings from last week
+granola meeting list --since "last week"
+
+# Find all standups
+granola meeting list --search standup
+
+# Find meetings with a specific person
+granola meeting list --attendee "sarah"
 
 # Review AI-enhanced summary from a meeting
 granola meeting enhanced a1b2c3d4
@@ -639,8 +685,16 @@ for id in $(granola meeting list --workspace abc12345 --output json | jq -r '.[]
   granola meeting export "$id" > "meetings/${id}.json"
 done
 
-# Find meetings mentioning a keyword
-granola meeting list --output json | jq '.[] | select(.title | test("planning"; "i"))'
+# Export all meetings from last month
+for id in $(granola meeting list --since "last month" --output json | jq -r '.[].id'); do
+  granola meeting export "$id" > "meetings/${id}.json"
+done
+
+# Find meetings with title search (built-in)
+granola meeting list --search "planning"
+
+# Find meetings with a specific attendee
+granola meeting list --attendee "john.smith@example.com" --output json
 ```
 
 ### Integration with Other Tools
@@ -687,7 +741,7 @@ npm install
 
 ### Testing
 
-The project uses [Vitest](https://vitest.dev/) for testing with 100% code coverage.
+The project uses [Vitest](https://vitest.dev/) for testing with high code coverage (95%+ threshold).
 
 ```bash
 # Run tests
@@ -720,7 +774,9 @@ granola-cli/
 │       ├── api.ts           # Granola API client
 │       ├── auth.ts          # Credential management
 │       ├── config.ts        # Configuration management
+│       ├── date-parser.ts   # Natural date parsing
 │       ├── debug.ts         # Debug logging utilities
+│       ├── filters.ts       # Meeting filter utilities
 │       ├── http.ts          # HTTP client with retry
 │       ├── output.ts        # Table formatting
 │       ├── pager.ts         # Pager integration