@theplato/tiro-cli 0.5.0 → 0.6.1

package/README.md

@@ -111,6 +111,7 @@ tiro notes list                                              # pretty table in T
 tiro notes list --json                                       # NDJSON for pipes
 tiro notes list --keyword "OKR" --since 30d                  # Reorder by keyword relevance
 tiro notes list --folder <id> --limit 100 --cursor <token>
+tiro notes list --workspace <guid>                           # scope to one workspace
 ```
 
 ### Deep keyword search (returns notes + their primary documents)
@@ -118,10 +119,19 @@ tiro notes list --folder <id> --limit 100 --cursor <token>
 tiro notes search "Q3 Planning"                              # positional keyword
 tiro notes search "OKR" --since 2026-04-01 --until 2026-05-01
 tiro notes search "Acme Corp" --folder <id> --json | jq '.[] | .guid'
+tiro notes search "release" --workspace <guid>               # scope to one workspace
 ```
 
 `--since` / `--until` accept ISO-8601 (`2026-04-01T10:00:00Z`) or relative (`7d`, `24h`, `30m`).
 
+**Workspace scoping.** `notes list` / `notes search` resolve their workspace in this
+order: explicit `--workspace <guid>` first, then the workspace your API key is bound
+to (workspace-scoped keys), then — for an unbound credential (a personal key or an
+OAuth login) — **across every workspace you belong to**, with a one-line warning to
+stderr. Unlike `wiki`, notes are never silently pinned to a single "default"
+workspace. Run `tiro wiki workspaces` for guids, or `tiro auth status` to see which
+workspace your credential is bound to.
+
 ### Get one note → stdout
 ```bash
 tiro notes get <guid>                                        # markdown to TTY
@@ -151,6 +161,28 @@ header instead of being attached to every speaker line. Use
 
 `--format json` returns the exact shape MCP's `get_note_transcript` emits (`{noteGuid, title, participants, createdAt, recordingDurationSeconds, paragraphs[]}` with each paragraph carrying `segments[]` of `{content, speaker:{label,name}|null}`).
 
+### Browse workspace folders
+```bash
+tiro folders list                                            # flat list (id, sharingType, title)
+tiro folders list --workspace <guid> --json
+tiro folders tree --workspace <guid>                         # hierarchy, indented by depth
+```
+
+Folders are workspace-scoped. The workspace resolves from `--workspace`, else your
+API key's bound workspace. Unlike notes, folders have no cross-workspace path — an
+unbound credential must pass `--workspace` (run `tiro wiki workspaces` for guids).
+Use a folder id with `tiro notes list --folder <id>`. `sharingType` is one of
+`PRIVATE` / `ALL_MEMBER_VIEWER` / `ALL_MEMBER_EDITOR` / `LIMITED`.
+
+### List word memories
+```bash
+tiro word-memories list                                      # custom transcription vocabulary
+tiro word-memories list --workspace <guid> --json
+```
+
+Word memories are the custom vocabulary that biases a workspace's transcription.
+Read-only and workspace-scoped (same resolution as folders).
+
 ### Explore the workspace wiki
 
 The wiki is Tiro's auto-extracted knowledge graph (entities, concepts, and their
@@ -186,6 +218,19 @@ The CLI is the agent's *feet* (read, save, browse). The hosted MCP at
 tool calls inside the loop). See [`AGENTS.md`](./AGENTS.md) for the full
 agent contract.
 
+### Stay up to date
+```bash
+tiro update --check          # is a newer version available? (JSON for agents/CI)
+tiro update                  # self-update to the latest published version
+tiro update --dry-run        # print the upgrade command without running it
+tiro update --pm pnpm        # force a package manager (default: auto-detected)
+```
+
+`tiro update` upgrades by running your global package manager (npm, pnpm, yarn,
+or bun — auto-detected). In a TTY a banner also appears when a newer version is
+published; agents and CI should poll `tiro update --check` (it exits 0 and
+reports `updateAvailable`). Disable the banner with `NO_UPDATE_NOTIFIER=1`.
+
 ---
 
 ## Commands
@@ -203,11 +248,17 @@ tiro notes transcript      Get the full transcript (matches MCP get_note_transcr
 tiro mcp info              Show hosted MCP endpoint info
 tiro mcp install           Print one-line claude-mcp-add command
 
-# Coming in v0.4:
+tiro update                Self-update to the latest version (--check / --dry-run)
+
+tiro wiki search/page      Read the workspace knowledge graph
+tiro wiki mentions/graph   Page mentions and graph slices
+tiro folders list/tree     Browse workspace folders (flat or hierarchy)
+tiro word-memories list    List custom transcription vocabulary
+
+# Coming later:
 tiro notes export          Bulk-export search results to a directory
 tiro templates list/get    Document templates
 tiro share-links {C/R/D}   Manage note share links
-tiro folders search        Search user / team folders
 tiro schema [<command>]    Print JSON Schema (for agents)
 ```
 
@@ -337,8 +388,9 @@ OAuth Authorization Code + PKCE flow:
 
 - ✅ **v0.1** — Auth (`login`, `status`, `logout`) + `--help`
 - ✅ **v0.2** — Notes core (`list`, `search`, `get`, `transcript`); MCP-shape transcript JSON; first test suite
-- ⏳ **v0.3** — `notes export` (bulk → directory + manifest.jsonl)
-- ⏳ **v0.4** — Templates, share-links, folders, `schema`
+- ✅ **v0.5** — `wiki` command group (workspace knowledge graph, read-only)
+- ✅ **v0.6** — `folders` and `word-memories` (workspace-scoped, read-only)
+- ⏳ **next** — `notes export`, templates, share-links, `schema`
 - ⏳ **v1.0** — Stable. Public docs, license decision, Homebrew tap.
 - 🔮 **v1.x** — Device Flow (RFC 8628), shell completions, self-update