@theplato/tiro-cli 0.4.1 → 0.6.0

package/README.md

@@ -46,6 +46,7 @@ The CLI is **not a replacement for MCP**. It's the same data through a different
 - 🔐 **OAuth Authorization Code + PKCE** — no copy-paste tokens, no secrets in shell history. Tokens live in OS Keychain.
 - 📁 **`--output` writes to disk** — stdout becomes a single line of metadata. Agents stay context-light.
 - 🪞 **Same JSON shape as MCP** — `tiro notes transcript --format json` mirrors `get_note_transcript` exactly. Switch surfaces without changing parsers.
+- 🕸️ **Workspace wiki** — `tiro wiki search / page / mentions / graph` read the auto-extracted knowledge graph; `--workspace` targets a specific workspace.
 - 🧵 **NDJSON streams by default** — pipe to `jq`, `head`, `xargs`. No buffer-in-memory surprises.
 - 🤖 **Agent-aware** — TTY detection auto-selects pretty vs JSON. `error.suggestion` field for auto-recovery.
 - 🚫 **No voice in v1** — intentionally matches MCP feature parity (audio uploads belong elsewhere).
@@ -110,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)
@@ -117,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
@@ -150,6 +161,50 @@ 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
+links) over your notes. These commands are **read-only** and mirror the MCP wiki
+tools. Wiki is a paid, opt-in feature — calls against an ineligible or
+not-activated workspace return the backend's upgrade message and a non-zero exit.
+
+```bash
+tiro wiki workspaces                                         # which workspaces? (guid + wiki on/off)
+tiro wiki search "Ontology" --workspace <guid>               # find pages by keyword
+tiro wiki page <pageGuid> --workspace <guid>                 # body + mentions + links
+tiro wiki mentions <pageGuid> --workspace <guid>             # where the page is grounded in notes
+tiro wiki graph <pageGuid> --mode around --workspace <guid>  # neighborhood graph
+tiro wiki graph --mode seed --type CONCEPT --workspace <guid> # overview graph (no pageGuid)
+```
+
+`--workspace` is optional — omit it to use the default workspace for your API
+key. If your account belongs to multiple workspaces, run `tiro wiki workspaces`
+first and pass the `guid` of the one whose wiki is enabled. `graph` results are
+capped (default 50 nodes); a `truncated: true` flag signals you to narrow the
+query.
+
 ### Connect to Claude Code (MCP)
 ```bash
 tiro mcp install
@@ -180,11 +235,15 @@ 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 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)
 ```
 
@@ -314,8 +373,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
 
@@ -325,7 +385,7 @@ See [`SPEC.md`](./SPEC.md) for the full v1 design and [`CHANGELOG.md`](./CHANGEL
 
 ## Contributing
 
-This repo is currently private alpha. Feedback and bug reports go to the internal Slack `#tiro-backend` channel; once we open up, this section will list public contribution guidelines.
+This repo is currently private alpha. Feedback and bug reports can be sent to [yeoul@theplato.io](mailto:yeoul@theplato.io); once we open up, this section will list public contribution guidelines.
 
 ---