Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 12 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ what you promised in yesterday's call, and get the answer with a reference to th
> **You:** I have a call with Bob Sample at three. What did we agree last time, and what do I owe him?

```sh
zm personal remote-meetings list --json # your upcoming meetings
zm personal meetings scheduled --json # your scheduled series
zm personal meetings people "Bob Sample" --json # him among past participants
zm personal search meetings "quote" --since-time 2026-09-01 --json
zm personal meetings passage meeting:1/42/57/118 --format markdown # the line and its context
Expand Down Expand Up @@ -147,13 +147,13 @@ More: [compared with other tools](https://github.com/WireCatLabs/zoom-cli/blob/m
| Bring meetings in | `meetings sync [--since-time <time>] [--lookback-days <days>]`, `meetings import <folder>`, `watch [api\|files] [folder] --jsonl` |
| Read stored meetings | `meetings list`, `meetings show <meeting>`, `meetings transcript <meeting>`, `meetings summary <meeting>`, `meetings export <meeting> --format markdown\|vtt`, `events list` |
| Search | `search meetings <query>`, `meetings people <query>`, `search all <query>` |
| Evidence and people | `meetings passage <reference>`, `meetings evidence <reference>`, `meetings context <person>`, `meetings link <reference>`, `meetings update <reference>`, `meetings task-proposal <reference> --type <type>` |
| Evidence and people | `meetings passage <reference>`, `meetings evidence <reference>`, `meetings context <person>`, `meetings link <reference>`, `meetings task-proposal <reference> --type <type>` |
| Several reads at once | `batch <file>` runs bounded `search meetings` and `meetings passage` requests from a JSON file |
| Search by meaning | `search meetings <query> --model <model>`, `meetings embeddings --model <model>` |
| Local transcription | `meetings transcribe <meeting> <file> --model <model>` |
| Cloud recordings | `recordings list`, `recordings show <meeting>`, `recordings download <meeting> --output-dir <dir>`, `recordings download --since-time <date> --until-time <date> --output-dir <dir> --jsonl`, `recordings schedule create\|list\|show\|run\|disable` |
| Local archive | `recordings archive show\|check\|locks\|recover <directory>`, `recordings archive transcript\|import <directory>`, `search recordings <directory> <query>` |
| Zoom meetings | `remote-meetings list\|show\|invitation`, `remote-meetings create\|update\|cancel` |
| Zoom meetings | `meetings invitation <meeting>`, `meetings create\|update\|cancel` |
| Zoom contacts | `contacts list [name:… email:… type:company\|external]`, `contacts show <member id\|email>` |
| What zm did | `runs list [query]`, `runs show <run-id> [--problems]`, `runs path <run-id>`; `--record` keeps a successful run too |
| Zoom's own search | `zoom search`: chat, docs and meetings zm does not archive, read live |
Expand Down Expand Up @@ -278,7 +278,8 @@ with the profile it speaks for:

The server offers zm's commands as the three tools every WireCat CLI serves — `zm_tools_search`, `zm_read`,
`zm_write` — and runs each call as the command line would. The profile's [permissions][docs/configuration.md]
decide what it offers: `{"remote-meetings": "readonly"}` keeps an agent from changing Zoom meetings. A desktop app
decide what it offers: `{"meetings.create": "readonly", "meetings.update": "readonly", "meetings.cancel": "readonly"}` keeps an agent
from changing Zoom meetings. A desktop app
may need the full path from `command -v zm` (Linux/macOS) or `where.exe zm` (Windows), and the same `ZM_CONFIG_DIR`
or `MESSAGING_STORE` in the entry's `env`.

Expand All @@ -288,15 +289,15 @@ More: [MCP and skills][docs/mcp.md] · [MCP and skills on wirecat.dev][wirecat/e
## Manage Zoom meetings

```sh
zm personal remote-meetings create --title "Example planning" --start-time 2026-10-20T10:00:00Z --duration-minutes 30 --dry-run --json
zm personal remote-meetings cancel 123456789 --dry-run --json
zm personal meetings create --title "Example planning" --start-time 2026-10-20T10:00:00Z --duration-minutes 30 --dry-run --json
zm personal meetings cancel 123456789 --dry-run --json
```

Creation, updates and cancellation preview until you add `--yes`, and are never retried
automatically. An uncertain outcome exits with code 14: check Zoom before repeating. Remote ids are
Zoom's numeric ids; stored `meetings` commands use local ids.
automatically. An uncertain outcome exits with code 14: check Zoom before repeating. These take Zoom's meeting
number.

More: [managing Zoom meetings][docs/remote-meetings.md] · [Zoom on wirecat.dev][wirecat/en/docs/zoom]
More: [managing Zoom meetings][docs/meeting-management.md] · [Zoom on wirecat.dev][wirecat/en/docs/zoom]

## Output, limits and deadlines

Expand Down Expand Up @@ -376,7 +377,7 @@ repository's issues.
| [Search and evidence][docs/search.md] | word search, evidence, people, links, memo |
| [Topic search][docs/topic-search.md] | search by meaning with a model you choose |
| [MCP and skills][docs/mcp.md] | the skill, the MCP server, optional tools |
| [Managing Zoom meetings][docs/remote-meetings.md] | upcoming meetings, create, update, cancel |
| [Managing Zoom meetings][docs/meeting-management.md] | invitation, create, update, cancel |
| [Commands][docs/commands.md] | every command, option and exit code (generated) |
| [Configuration][docs/configuration.md] | settings and environment variables |
| [Troubleshooting][docs/troubleshooting.md] | by symptom |
Expand Down Expand Up @@ -421,7 +422,7 @@ More: [development setup][docs/dev/development.md] · [test matrix][docs/dev/tes
[docs/index.md]: https://github.com/WireCatLabs/zoom-cli/blob/main/docs/index.md
[docs/installation.md]: https://github.com/WireCatLabs/zoom-cli/blob/main/docs/installation.md
[docs/mcp.md]: https://github.com/WireCatLabs/zoom-cli/blob/main/docs/mcp.md
[docs/remote-meetings.md]: https://github.com/WireCatLabs/zoom-cli/blob/main/docs/remote-meetings.md
[docs/meeting-management.md]: https://github.com/WireCatLabs/zoom-cli/blob/main/docs/meeting-management.md
[docs/search.md]: https://github.com/WireCatLabs/zoom-cli/blob/main/docs/search.md
[docs/security.md]: https://github.com/WireCatLabs/zoom-cli/blob/main/docs/security.md
[docs/sessions.md]: https://github.com/WireCatLabs/zoom-cli/blob/main/docs/sessions.md
Expand Down
30 changes: 30 additions & 0 deletions changes/feat-meetings-find-get-management.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
### Added

- **`meetings show` reads a meeting that ran again from Zoom,** with its people and transcript, by the instance uuid
that `meetings sync` stores or by its meeting number (then its latest instance). It needs the optional
`meeting:read:past_meeting` scope: add it to the Zoom app and run `zm <profile> session start` again. Without it,
`meetings show` says the scope is missing.
- **`meetings list` finds meetings that ran in Zoom and are not stored yet.** It asks Zoom one month of the
`started_at` window at a time, newest first, and reads the runs of at most 20 meetings a request, so one list sends
at most 126 requests. Without `started_at` it starts at today and reaches back as far as Zoom lists past meetings,
6 months. When it stops before the end, the answer says it is not complete (`meetings.server-capped`) and asks for a
narrower `started_at`. Meetings that have not run yet are not in it: `meetings scheduled` lists those.
- **`meetings create|update|cancel|invitation`** change a Zoom meeting or read its invitation, through cli-core's
shared meeting management. A create needs `--start-time`; zm does not start an instant meeting. A change zm cannot
send is refused before the question.

### Changed — may break callers

- **`remote-meetings` is gone.** Use `meetings create`, `meetings update`, `meetings cancel` and
`meetings invitation`. `remote-meetings list` and `remote-meetings show` for an upcoming meeting have no
replacement: `meetings scheduled` lists scheduled series, and `meetings show` answers for meetings that ran.
- **`--dry-run` on `meetings create|update|cancel` shows the command and its permission,** not the request zm would
send to Zoom, and does not check the change. A change Zoom cannot take is refused when it runs, before the question.
- **A saved `remote-meetings` permission key stops every command** until it is removed with
`zm <profile> config unset permissions.remote-meetings`. Set `meetings.create`, `meetings.update` or
`meetings.cancel` instead. These ask first by default.
- **`meetings update <reference> --event-id` is now `meetings link <reference> --event-id`.** `meetings update`
changes a meeting in Zoom.
- **Built on cli-core 0.667.0 and cli-base 0.102.1** (was 0.663.0 and 0.100.0). `--json <fields>` keeps the
untrusted marks of other people's text. See the
[cli-core changelog](https://github.com/WireCatLabs/cli-core/blob/main/CHANGELOG.md).
7 changes: 0 additions & 7 deletions contracts/own-catalogue.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@
"config unset": "write",
"config migrate": "write",
"app": "read",
"meetings update": "write",
"meetings link": "write",
"meetings transcribe": "write",
"meetings evidence": "read",
Expand All @@ -30,12 +29,6 @@
"recordings schedule run": "write",
"recordings schedule disable": "write",
"recordings status": "read",
"remote-meetings list": "read",
"remote-meetings show": "read",
"remote-meetings invitation": "read",
"remote-meetings create": "write",
"remote-meetings update": "write",
"remote-meetings cancel": "write",
"contacts list": "read",
"contacts show": "read",
"zoom search": "read",
Expand Down
158 changes: 53 additions & 105 deletions contracts/wirecat.json
Original file line number Diff line number Diff line change
Expand Up @@ -341,6 +341,58 @@
"permission": "meetings.repair",
"entity": "meeting_repair"
},
{
"path": [
"meetings",
"create"
],
"summary": "create a meeting on the service",
"effects": {
"remote": "write",
"local": "write"
},
"permission": "meetings.create",
"entity": "meeting_change"
},
{
"path": [
"meetings",
"update"
],
"summary": "change a meeting on the service",
"effects": {
"remote": "write",
"local": "write"
},
"permission": "meetings.update",
"entity": "meeting_change"
},
{
"path": [
"meetings",
"cancel"
],
"summary": "cancel a meeting on the service",
"effects": {
"remote": "write",
"local": "write"
},
"permission": "meetings.cancel",
"entity": "meeting_change"
},
{
"path": [
"meetings",
"invitation"
],
"summary": "the invitation text the service writes for a meeting",
"effects": {
"remote": "read",
"local": "read"
},
"permission": "meetings.invitation",
"entity": "meeting_invitation"
},
{
"path": [
"meetings",
Expand Down Expand Up @@ -395,25 +447,12 @@
"permission": "meetings.prepare",
"entity": "meeting_preparation"
},
{
"path": [
"meetings",
"update"
],
"summary": "preview linking a stored meeting to an event; --yes applies it",
"effects": {
"remote": "none",
"local": "write"
},
"permission": "meetings.update",
"entity": "meeting_association"
},
{
"path": [
"meetings",
"link"
],
"summary": "preview linking a meeting participant to a stored person; --yes applies it",
"summary": "link a meeting to an event, or a participant to a person; --yes applies",
"effects": {
"remote": "none",
"local": "write"
Expand Down Expand Up @@ -868,84 +907,6 @@
"permission": "recordings.status",
"entity": "sync_progress"
},
{
"path": [
"remote-meetings",
"list"
],
"summary": "list upcoming meetings",
"effects": {
"remote": "read",
"local": "read"
},
"permission": "remote-meetings.list",
"entity": "zoom_remote_meeting"
},
{
"path": [
"remote-meetings",
"show"
],
"summary": "show an upcoming meeting",
"effects": {
"remote": "read",
"local": "read"
},
"permission": "remote-meetings.show",
"entity": "zoom_remote_meeting"
},
{
"path": [
"remote-meetings",
"invitation"
],
"summary": "read invitation text",
"effects": {
"remote": "read",
"local": "read"
},
"permission": "remote-meetings.invitation",
"entity": "zoom_remote_invitation"
},
{
"path": [
"remote-meetings",
"create"
],
"summary": "create a Zoom meeting; asks first, --dry-run previews",
"effects": {
"remote": "write",
"local": "write"
},
"permission": "remote-meetings.create",
"entity": "zoom_remote_change"
},
{
"path": [
"remote-meetings",
"update"
],
"summary": "change a Zoom meeting; asks first, --dry-run previews",
"effects": {
"remote": "write",
"local": "write"
},
"permission": "remote-meetings.update",
"entity": "zoom_remote_change"
},
{
"path": [
"remote-meetings",
"cancel"
],
"summary": "cancel a Zoom meeting; asks first, --dry-run previews",
"effects": {
"remote": "write",
"local": "write"
},
"permission": "remote-meetings.cancel",
"entity": "zoom_remote_change"
},
{
"path": [
"contacts",
Expand Down Expand Up @@ -1286,19 +1247,6 @@
"state"
]
},
"zoom_remote_meeting": {
"fields": [
"id",
"uuid",
"title",
"type",
"started_at",
"duration_minutes",
"timezone",
"agenda",
"join_url"
]
},
"contact": {
"fields": [
"name",
Expand Down
Loading
Loading