@andrzejchm/notion-cli 0.7.0 → 0.9.0

package/README.md

@@ -37,7 +37,7 @@ Fetch and follow instructions from https://raw.githubusercontent.com/andrzejchm/
 - **`notion db query`** — filter, sort, and select columns from any database
 - **`notion append`** — append markdown content to an existing page
 - **`notion create-page`** — create a new page with markdown body, prints URL to stdout
-- **`notion comment`** — add a comment to a page
+- **`notion comment`** — add a comment to a page, block, or discussion thread
 - **Agent-friendly** — plain text tables by default; `--json` for machine-readable output
 - **Flexible auth** — interactive setup or `NOTION_API_TOKEN` env var
 - **Accepts URLs** — pass full Notion URLs anywhere an ID is expected
@@ -70,6 +70,12 @@ my-summarize-command | notion create-page --parent "$PAGE_ID" --title "Auto Summ
 # Add a comment to a page
 notion comment "$PAGE_ID" -m "Reviewed and approved."
 
+# Reply to an existing discussion thread
+notion comment --reply-to "$DISCUSSION_ID" -m "Agreed, let's proceed."
+
+# Comment on a specific block
+notion comment --block "$BLOCK_ID" -m "This section needs revision."
+
 # List everything your integration can access
 notion ls
 ```
@@ -85,22 +91,32 @@ notion ls
 | `notion auth status` | Show current auth state |
 | `notion auth list` | List all saved profiles |
 | `notion auth use <name>` | Switch the active profile |
-| `notion search <query>` | Search pages and databases by title |
-| `notion ls` | List all accessible pages and databases |
+| `notion search <query>` | Search pages and databases by title (`--sort asc\|desc`) |
+| `notion ls` | List all accessible pages and databases (`--sort asc\|desc`) |
 | `notion open <id\|url>` | Open a page in your browser |
 | `notion read <id\|url>` | Read a page as markdown |
 | `notion db schema <id\|url>` | Show database property schema and valid values |
 | `notion db query <id\|url>` | Query database entries with filtering and sorting |
 | `notion users` | List workspace members |
 | `notion comments <id\|url>` | Read page comments |
-| `notion comment <id\|url> -m <text>` | Add a comment to a page |
+| `notion comment [id\|url] -m <text>` | Add a comment to a page, block, or thread |
 | `notion append <id\|url> -m <markdown>` | Append markdown blocks to a page |
 | `notion edit-page <id\|url> --find <old> --replace <new>` | Search-and-replace text on a page |
 | `notion edit-page <id\|url> -m <markdown>` | Replace entire page content |
 | `notion create-page --parent <id\|url> --title <title>` | Create a new page, prints URL |
 | `notion update <id\|url> --prop "Name=Value"` | Update properties on a page |
+| `notion archive <id\|url>` | Archive (trash) a page |
 | `notion completion bash\|zsh\|fish` | Install shell tab completion |
 
+### `notion search` / `notion ls` flags
+
+| Flag | Example | Description |
+|------|---------|-------------|
+| `--sort` | `--sort desc` | Sort by last edited time (`asc` or `desc`) |
+| `--type` | `--type page` | Filter by object type (`page` or `database`) |
+| `--cursor` | `--cursor <cursor>` | Pagination cursor from a previous `--next` hint |
+| `--json` | `--json` | Force JSON output |
+
 ### `notion db query` flags
 
 | Flag | Example | Description |