@heyditto/cli 1.5.0 → 1.6.0

package/README.md

@@ -88,19 +88,43 @@ heyditto save <content> [--source <s>] [--source-context <c>]
 heyditto search <query>... [--include-public] [--filter-username <u>]
 heyditto fetch <id>... [--memory-format full|outline|blocks]
 heyditto list [--username <u>] [--limit <n>] [--offset <n>] [--source <s>]
+heyditto my-memories [--limit <n>] [--offset <n>] [--source <s>]
 heyditto update <id> [--content <text>|--content-file <path>] [--title <t>]
              [--source-context <c>] [--edits-json <json>|--edits-file <path>]
              [--base-revision <n>]
 heyditto publish <id> [--title <t>] [--privacy-mode <mode>]
 heyditto unpublish (--memory-id <id>|--share-id <id>|<id>)
+heyditto delete <memory-id> --confirm
 heyditto subjects <query> [--top-k <n>]
+heyditto subject-edges <subject-id> [--limit <n>] [--min-weight <n>] [--kg <alias>]
 heyditto memories <subject-id>... [--query <q>]
 heyditto network <pair-id> [--limit <n>]
-heyditto graphs create <name> | list | add <@username> | remove <@username> | subscribers
-heyditto init --agent [--agent-caller <name>] [--json]
-heyditto status
+heyditto friends
+heyditto knowledge-graphs
+heyditto graph-sharing (--enable|--disable) [--title <t>] [--description <d>]
+heyditto graphs create <name>
+heyditto graphs list
+heyditto graphs available
+heyditto graphs add <@username>
+heyditto graphs remove <@username>
+heyditto graphs subscribers
+heyditto graphs sharing (--enable|--disable) [--title <t>] [--description <d>]
+heyditto init --agent [--agent-caller <name>] [--subscribe <@graph>] [<@graph>...] [--json]
+heyditto login [<key>] [--paste] [--stdin]
+heyditto logout
+heyditto status [--output <format>]
 heyditto config
-heyditto help
+heyditto help [command]
+```
+
+### Help
+
+Use `-h` or `--help` globally or after any command:
+
+```bash
+heyditto --help
+heyditto search --help
+heyditto graphs add --help
 ```
 
 ### `save`
@@ -142,8 +166,13 @@ List saved memories, or public DittoHub publishes for a username.
 ```bash
 heyditto list --limit 10
 heyditto list --username peyton --limit 10 --output json
+heyditto my-memories --source cli --limit 10 --output json
 ```
 
+`my-memories` is the CLI wrapper for `list_my_memories`. It only lists your
+saved memories, while `list --username <u>` can switch to public DittoHub
+publishes for another user.
+
 ### `update`
 
 Edit a saved memory in place. Replace the full body with `--content` or
@@ -154,10 +183,7 @@ Block edits require the current revision returned by `save` or a previous
 ```bash
 heyditto update <memory-id> --content-file revised.md --output json
 heyditto fetch <memory-id> --memory-format outline --output json
-heyditto update <memory-id> \
-  --edits-json '[{"op":"replace_text","blockId":"2","find":"old","replace":"new","expectedCount":1}]' \
-  --base-revision 3 \
-  --output json
+heyditto update <memory-id> --edits-file edits.json --base-revision 3 --output json
 ```
 
 ### `publish` / `unpublish`
@@ -170,6 +196,15 @@ heyditto publish <memory-id> --title "Launch notes" --privacy-mode scan_and_bloc
 heyditto unpublish --share-id abc123def4 --output json
 ```
 
+### `delete`
+
+Permanently delete a saved memory. This is destructive, so the CLI requires
+`--confirm`.
+
+```bash
+heyditto delete <memory-id> --confirm --output json
+```
+
 ### `subjects`
 
 Search the subject (topic) graph. Returns subject ids you can pass to `memories` or `network`.
@@ -177,8 +212,11 @@ Search the subject (topic) graph. Returns subject ids you can pass to `memories`
 ```bash
 heyditto subjects "memory architecture"
 heyditto subjects "performance" --top-k 5
+heyditto subject-edges <subject-id> --limit 10 --min-weight 0.5 --output json
 ```
 
+`subject-edges` is the CLI wrapper for `get_subject_edges`.
+
 ### `memories`
 
 Fetch memory previews scoped to specific subjects.
@@ -196,6 +234,14 @@ Traverse a memory's network (related memories via shared subjects).
 heyditto network <pair-id> --limit 30
 ```
 
+### `friends`
+
+List Ditto friends for commands that need usernames.
+
+```bash
+heyditto friends --output json
+```
+
 ### `graphs`
 
 Manage the public knowledge graphs you're subscribed to. Subscribed graphs are
@@ -206,9 +252,18 @@ your own graph or an app's graph, since those aren't subscriptions.
 ```bash
 heyditto graphs create feedback-triager  # create a NEW dedicated graph you own (mint its CI key in the Ditto UI)
 heyditto graphs list              # graphs you're subscribed to
+heyditto graphs available         # readable knowledge graphs, including main/app graphs
 heyditto graphs add @minos        # subscribe to @minos's public graph
 heyditto graphs remove @minos     # unsubscribe
 heyditto graphs subscribers       # who's subscribed to your graph
+heyditto graphs sharing --disable # disable public subscriptions to your graph
+```
+
+Top-level aliases are also available:
+
+```bash
+heyditto knowledge-graphs --output json
+heyditto graph-sharing --enable --title "Support Graph" --description "Public support notes"
 ```
 
 ### `status`