@genspark/cli 1.12.0 → 1.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/README.md +132 -5
  2. package/dist/client.d.ts +77 -2
  3. package/dist/client.d.ts.map +1 -1
  4. package/dist/client.js +379 -3
  5. package/dist/client.js.map +1 -1
  6. package/dist/commands/developer-preflight.d.ts +17 -0
  7. package/dist/commands/developer-preflight.d.ts.map +1 -0
  8. package/dist/commands/developer-preflight.js +131 -0
  9. package/dist/commands/developer-preflight.js.map +1 -0
  10. package/dist/commands/developer-project.d.ts +5 -0
  11. package/dist/commands/developer-project.d.ts.map +1 -0
  12. package/dist/commands/developer-project.js +140 -0
  13. package/dist/commands/developer-project.js.map +1 -0
  14. package/dist/commands/genspark-code-skills.d.ts +23 -0
  15. package/dist/commands/genspark-code-skills.d.ts.map +1 -0
  16. package/dist/commands/genspark-code-skills.js +49 -0
  17. package/dist/commands/genspark-code-skills.js.map +1 -0
  18. package/dist/commands/genteam-download.d.ts +34 -0
  19. package/dist/commands/genteam-download.d.ts.map +1 -0
  20. package/dist/commands/genteam-download.js +95 -0
  21. package/dist/commands/genteam-download.js.map +1 -0
  22. package/dist/commands/hosted-local.d.ts +10 -0
  23. package/dist/commands/hosted-local.d.ts.map +1 -0
  24. package/dist/commands/hosted-local.js +116 -0
  25. package/dist/commands/hosted-local.js.map +1 -0
  26. package/dist/commands/local-command-routing.d.ts +8 -0
  27. package/dist/commands/local-command-routing.d.ts.map +1 -0
  28. package/dist/commands/local-command-routing.js +33 -0
  29. package/dist/commands/local-command-routing.js.map +1 -0
  30. package/dist/commands/local-preview.d.ts +5 -0
  31. package/dist/commands/local-preview.d.ts.map +1 -0
  32. package/dist/commands/local-preview.js +35 -0
  33. package/dist/commands/local-preview.js.map +1 -0
  34. package/dist/config.d.ts +1 -1
  35. package/dist/config.d.ts.map +1 -1
  36. package/dist/config.js +1 -1
  37. package/dist/config.js.map +1 -1
  38. package/dist/developer-contract.d.ts +24 -0
  39. package/dist/developer-contract.d.ts.map +1 -0
  40. package/dist/developer-contract.js +64 -0
  41. package/dist/developer-contract.js.map +1 -0
  42. package/dist/index.d.ts.map +1 -1
  43. package/dist/index.js +358 -19
  44. package/dist/index.js.map +1 -1
  45. package/dist/local-source.d.ts +22 -0
  46. package/dist/local-source.d.ts.map +1 -0
  47. package/dist/local-source.js +204 -0
  48. package/dist/local-source.js.map +1 -0
  49. package/dist/project-binding.d.ts +31 -0
  50. package/dist/project-binding.d.ts.map +1 -0
  51. package/dist/project-binding.js +141 -0
  52. package/dist/project-binding.js.map +1 -0
  53. package/dist/types.d.ts +14 -0
  54. package/dist/types.d.ts.map +1 -1
  55. package/docs/skills.md +1 -1
  56. package/package.json +4 -2
  57. package/skills/gsk-aidrive/SKILL.md +94 -24
  58. package/skills/gsk-audio-generation/SKILL.md +1 -1
  59. package/skills/gsk-claw-share-link/SKILL.md +1 -1
  60. package/skills/gsk-genteam/SKILL.md +1 -1
  61. package/skills/gsk-google-calendar/SKILL.md +2 -1
  62. package/skills/gsk-meeting/SKILL.md +1 -0
  63. package/skills/gsk-outlook-calendar/SKILL.md +2 -1
  64. package/skills/gsk-sb-brain/SKILL.md +13 -82
  65. package/skills/gsk-second-brain/SKILL.md +179 -0
  66. package/skills/gsk-shared/SKILL.md +18 -0
  67. package/skills/gsk-slack/SKILL.md +8 -7
@@ -6,14 +6,19 @@ description: 'AI-Drive file storage and management, plus the generic web downloa
6
6
  direct file links) server-side into the drive and return a download link. Canonical
7
7
  actions: ls, find, mkdir, rm, move, get_readable_url, download, download_video,
8
8
  download_audio, download_file, compress, decompress, share, unshare, access, link,
9
- unlink, upload, list_trash, restore. `rm` moves native entries to recoverable trash
10
- and unlinks delegated aliases without touching their source. `ls` reads one directory;
11
- use indexed `find` to locate names across the drive. `shared_with_me` is a view
12
- across source containers; ls it first and reuse a returned `source_id`. A delegated
13
- LinkNode row returns `link_workspace_id`; reuse it as `--source` to mount the live
14
- source entry. `download <ai-drive-path> [local-path]` copies a drive file OUT to
15
- local disk (the path may be spelled `aidrive://...`); `download_file --file_url
16
- <url>` goes the opposite direction, saving an external URL INTO the drive.'
9
+ unlink, upload, list_trash, restore, tree, search, read, overview. Selected Context:
10
+ reuse source/id directly; read a known file, search a known topic, tree for bounded
11
+ structure and existing overviews. read returns a version, coverage, continuation
12
+ and source url. overview generates only with generate=true. `rm` moves native entries
13
+ to recoverable trash and unlinks delegated aliases without touching their source.
14
+ `ls` reads one directory; use indexed `find` to locate names across the drive. `shared_with_me`
15
+ is a view across source containers; list it only when no source is known, then reuse
16
+ `source_id`. A delegated LinkNode row returns `link_workspace_id`; reuse it as `--source`
17
+ to mount the live source entry. `download <ai-drive-path> [local-path]` copies a
18
+ drive file OUT to local disk (the path may be spelled `aidrive://...`); `download_file
19
+ --file_url <url>` goes the opposite direction, saving an external URL INTO the drive.
20
+ share / access / link replies carry `url`, the entry''s share link — hand that to
21
+ the user; `readable_url` is a one-hour bytes URL for tools.'
17
22
  metadata:
18
23
  category: general
19
24
  requires:
@@ -26,7 +31,9 @@ metadata:
26
31
 
27
32
  **PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
28
33
 
29
- AI-Drive file storage and management, plus the generic web downloader: download_video / download_audio / download_file fetch a URL (YouTube, social media, direct file links) server-side into the drive and return a download link. Canonical actions: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore. `rm` moves native entries to recoverable trash and unlinks delegated aliases without touching their source. `ls` reads one directory; use indexed `find` to locate names across the drive. `shared_with_me` is a view across source containers; ls it first and reuse a returned `source_id`. A delegated LinkNode row returns `link_workspace_id`; reuse it as `--source` to mount the live source entry. `download <ai-drive-path> [local-path]` copies a drive file OUT to local disk (the path may be spelled `aidrive://...`); `download_file --file_url <url>` goes the opposite direction, saving an external URL INTO the drive.
34
+ **THEN READ:** `../gsk-second-brain/SKILL.md` — it says what this command is part of and when to reach for it. This file keeps the flags.
35
+
36
+ AI-Drive file storage and management, plus the generic web downloader: download_video / download_audio / download_file fetch a URL (YouTube, social media, direct file links) server-side into the drive and return a download link. Canonical actions: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore, tree, search, read, overview. Selected Context: reuse source/id directly; read a known file, search a known topic, tree for bounded structure and existing overviews. read returns a version, coverage, continuation and source url. overview generates only with generate=true. `rm` moves native entries to recoverable trash and unlinks delegated aliases without touching their source. `ls` reads one directory; use indexed `find` to locate names across the drive. `shared_with_me` is a view across source containers; list it only when no source is known, then reuse `source_id`. A delegated LinkNode row returns `link_workspace_id`; reuse it as `--source` to mount the live source entry. `download <ai-drive-path> [local-path]` copies a drive file OUT to local disk (the path may be spelled `aidrive://...`); `download_file --file_url <url>` goes the opposite direction, saving an external URL INTO the drive. share / access / link replies carry `url`, the entry's share link — hand that to the user; `readable_url` is a one-hour bytes URL for tools.
30
37
 
31
38
  ## Usage
32
39
 
@@ -36,29 +43,66 @@ gsk drive [options]
36
43
 
37
44
  **Aliases:** `drive`
38
45
 
39
- ## GenTeam drive layout and permissions
46
+ ## What this command reaches
47
+
48
+ `gsk drive` opens the **Drive** half of the user's Second Brain — My Drive,
49
+ Team Drive, and the Shared-with-me view. For selected Context, start with the
50
+ commands below. Consult `../gsk-second-brain/SKILL.md` when you need to discover
51
+ an unknown source, resolve shortcuts, or work with GenTeam channel drives.
52
+
53
+ ## Reading selected Context
40
54
 
41
- GenTeam channel and DM drives are flat native containers. `mkdir`, directory
42
- upload, and moving/restoring native entries into subfolders are rejected with
43
- `GENTEAM_DRIVE_FLAT_LAYOUT`, including calls using an ID or browser URL. Admin
44
- access does not override this layout. Channel members with content-edit access
45
- can upload files at the root; moving, renaming, or deleting native files requires
46
- conversation administrator access. Removing a shared alias uses its existing
47
- sharing authorization and never removes its source.
55
+ Reuse the selected `source` and stable `id` without listing every shared source.
56
+ For a known file, call `read`; for a topic, call `search`; use `tree` when you
57
+ need structure. None of these requires generating an overview first.
58
+
59
+ ```bash
60
+ gsk aidrive tree --source '<selected-source>' --depth 2 --limit 100
61
+ gsk aidrive search --source '<selected-source>' --query 'Benefits' --query_scope subtree
62
+ gsk aidrive search --source '<selected-source>' --queries '["Benefits", "PTO"]'
63
+ gsk aidrive read --source '<selected-source>' --id '<entry_id>' --char_limit 12000
64
+ gsk aidrive read --source '<selected-source>' --id '<entry_id>' --offset 12000 --source_version '<version>'
65
+ gsk aidrive overview --source '<selected-source>' --id '<entry_id>'
66
+ gsk aidrive overview --source '<selected-source>' --id '<entry_id>' --generate true
67
+ ```
48
68
 
49
- Share a file or folder from an allowed source drive to the GenTeam drive root
50
- with `link`. Use that link's `link_workspace_id` to access the source folder: its
51
- own hierarchy and ACL remain intact. Existing native legacy folders may be read
52
- and removed for recovery, but cannot receive new files or be restored.
69
+ `tree` is breadth-first metadata, bounded by depth, nodes, bytes and query time.
70
+ Continue with its `cursor` and the same root/source/depth. Expand returned folder
71
+ IDs when deeper traversal or deferred expansion is needed. Overview fields are
72
+ existing source-language plain text; listing never generates them.
73
+
74
+ `search` supports `children`, `subtree` (default) and `drive` (drive-root only),
75
+ with `all`, `filename` or `content` search modes. Results are ranked index
76
+ candidates checked against the live selected scope. Follow the cursor even when
77
+ a bounded page is empty. `coverage`, `effective_mode` and `has_more` describe the
78
+ actual search; zero hits do not prove that unindexed source text is absent.
79
+ Use `queries` for up to three complementary queries sharing one output budget;
80
+ each result keeps its query and its own continuation cursor. Continue one query
81
+ with `query` and that cursor. Do not collapse distinct user conditions into one rewrite.
82
+ Index failure may explicitly fall back to filenames. Overview text is not indexed.
83
+
84
+ Pass each returned `entry_id` as `--id` and retain `source_id` as `--source`.
85
+ `read` returns character ranges from persisted indexed text, its source version,
86
+ available coverage and a human-openable `url`. A pending index has no evidence
87
+ yet; use its retry guidance or the existing download/format tools when necessary.
88
+ Do not treat partial extraction as a complete document. Successful reads can
89
+ refresh file and direct-parent overviews asynchronously from a complete cache.
90
+ Cite the returned source `url`, never a temporary `readable_url`.
91
+
92
+ For active Office documents and edits, use **wo-peer** with the returned
93
+ collaboration identifiers. Indexed text is a persisted snapshot, not the live
94
+ room. Download only when local processing requires it; editing does not require
95
+ download, replace and re-upload.
53
96
 
54
97
  ## Flags
55
98
 
56
99
  | Flag | Required | Description |
57
100
  |------|----------|-------------|
58
- | `<action>` (positional) | Yes | Action to perform (string, one of: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore) |
101
+ | `<action>` (positional) | Yes | Action to perform (string, one of: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore, tree, search, read, overview) |
59
102
  | `--workspace` | No | AI Drive location. my_drive owns your bytes and quota; shared_drive selects managed org, GenTeam, Hub, or authorized knowledge drives; shared_with_me is an ACL-filtered view across both kinds of container and owns no bytes or quota. GenTeam drives are flat: upload files or share source folders at the root; no native mkdir. Moving, renaming, and deleting native files requires an admin. (string, one of: my_drive, shared_with_me, shared_drive, default: `my_drive`) |
60
103
  | `--source` | No | Stable source_id returned by ls in shared_with_me or shared_drive. It identifies the storage-owning drive and entry; names are accepted only when unique. (string) |
61
104
  | `--share` | No | Deprecated alias for source, retained for older gsk scripts. (string) |
105
+ | `--scope` | No | For find only: search My Drive, accessible shared sources, or both. Use all when only a filename is known. Cannot combine with source/id/url; a specific source keeps the existing directory search behavior. Aggregate search is bounded; inspect coverage before concluding a file is absent. (string, one of: mine, shared, all) |
62
106
  | `--to` | No | Who to share with, for share/unshare: an email address; My Drive also accepts 'org' / 'group:<uid>' and 'channel:<server_id>:<channel_id>' (a GenTeam channel you belong to — the file is opened to its members and, unless post_card is false, posted there as a card). Managed Drive sources use email or general_access; a Team Drive source (workspace=shared_drive, source=<source_id>) also takes 'channel:…' — for its root, or for one entry inside it named by path (relative to the source) or id — when you manage sharing there. (string) |
63
107
  | `--post_card` | No | For share to a channel: also post the document card into the channel (default true). false opens the file to the channel's members without a message. (boolean, default: `True`) |
64
108
  | `--permission` | No | What the recipient or delegated mount may do: view or edit (share/link). The public link audience can only ever view. (string, one of: view, edit, default: `view`) |
@@ -66,8 +110,8 @@ and removed for recovery, but cannot receive new files or be restored.
66
110
  | `--general_access` | No | Who else can open it, for share without a recipient: restricted, org, or link. (string, one of: restricted, org, link) |
67
111
  | `--organization_id` | No | Which organization to share with, when you belong to more than one and use to=org or to=group:<uid>. (string) |
68
112
  | `--expires_at` | No | Optional ISO-8601 UTC instant after which the access stops, e.g. 2026-12-31T00:00:00+00:00. (string) |
69
- | `-p`, `--path` | No | Path to file or folder for ls, mkdir, rm, move, get_readable_url. For link: the existing source path in My Drive. For unlink: the LinkNode path in the selected managed source. For compress: folder path to compress. For decompress: archive file path to extract. For find: which directory to search. Omit it to search the whole of My Drive, or the root of the selected shared source. Naming a directory searches THAT DIRECTORY ONLY and does not descend into its subfolders — and a shared folder's own root is one such directory. To cover a subtree, find in each subfolder in turn. (string) |
70
- | `-q`, `--query` | No | Search keyword for find. Case-insensitive substring matching on the entry name, and on stored search metadata for typed links. A multi-word query matches entries containing EVERY word, in any order — 'budget 2025' finds '2025 budget'. Words are split on spaces only, so a space-free script (Chinese, Japanese) stays one term. (string) |
113
+ | `-p`, `--path` | No | Path to file or folder for ls, mkdir, rm, move, get_readable_url. For link: the existing source path in My Drive. For unlink: the LinkNode path in the selected managed source. For compress: folder path to compress. For decompress: archive file path to extract. For find: which directory to search. Omit it to search the whole of My Drive, or the root of the selected shared source. Naming a directory searches THAT DIRECTORY ONLY and does not descend into its subfolders — and a shared folder's own root is one such directory. To cover a subtree, use search with query_scope=subtree. tree/search/read/overview also accept a path relative to source or id. (string) |
114
+ | `-q`, `--query` | No | Search text. search uses ranked indexed text and names; see search_mode and query_scope. For find: case-insensitive substring matching on the entry name, and on stored search metadata for typed links. A multi-word query matches entries containing EVERY word, in any order — 'budget 2025' finds '2025 budget'. Words are split on spaces only, so a space-free script (Chinese, Japanese) stays one term. (string) |
71
115
  | `-f`, `--filter_type` | No | Filter by entry type for ls (improves performance): all (default), file, directory. Use 'file' when only need files. (string, one of: all, file, directory) |
72
116
  | `--file_type` | No | Filter by file MIME type for ls (improves performance): all (default), audio, video, image. Combine with filter_type='file' for best results. (string, one of: all, audio, video, image) |
73
117
  | `--target_path` | No | Destination entry path for move; destination directory for restore (the original filename is retained); destination directory inside the selected Team Drive source for link. (string) |
@@ -85,6 +129,17 @@ and removed for recovery, but cannot receive new files or be restored.
85
129
  | `--overwrite` | No | Set to true to overwrite the existing file at upload_path (upload action only; default false fails if the path exists). (boolean) |
86
130
  | `--content_type` | No | MIME type of the content. If not provided, will be auto-detected from filename. Common types: text/plain, text/markdown, application/json, text/csv (string) |
87
131
  | `--confirmed` | No | Set to true to confirm upload when: (1) file size > 1MB, or (2) content contains potentially sensitive patterns. If confirmation is required but not provided, upload will fail with a warning. (boolean) |
132
+ | `--queries` | No | For search: up to 3 queries in one request. Each returns its own cursor; omit query/cursor. (array) |
133
+ | `--query_scope` | No | For search: children, subtree (default), or drive (requires a selected drive root). (string, one of: children, subtree, drive, default: `subtree`) |
134
+ | `--search_mode` | No | For search: all (names and indexed text), filename, or content. Coverage is reported explicitly. (string, one of: all, filename, content, default: `all`) |
135
+ | `--limit` | No | Maximum results: tree 1–200 (default 100), search 1–50 (default 20). (integer) |
136
+ | `--byte_limit` | No | Maximum query output bytes: tree 4096–65536, search 8192–65536. Default 32768. (integer, default: `32768`) |
137
+ | `--depth` | No | Tree breadth-first depth, 1–6 (default 2). Expand a returned folder id for deeper browsing. (integer, default: `2`) |
138
+ | `--cursor` | No | Continue tree/search with its cursor and the same id/source/query. Restart if expired or changed. (string, default: ``) |
139
+ | `--offset` | No | Read character offset (default 0). Continuation requires the returned version. (integer, default: `0`) |
140
+ | `--char_limit` | No | Read character budget, 1–24000 (default 12000). (integer, default: `12000`) |
141
+ | `--source_version` | No | Source version returned by read; required for continuation. (string, default: ``) |
142
+ | `--generate` | No | For overview: true explicitly generates or regenerates. Default false reads existing overview/job only. (boolean, default: `False`) |
88
143
 
89
144
  ## Address by id or URL
90
145
 
@@ -98,6 +153,21 @@ and removed for recovery, but cannot receive new files or be restored.
98
153
  - Upload a file or directory with `gsk drive upload --local_file <local-path> --upload_path /destination` (add `--override` to replace existing files). For shared locations, also pass `--workspace shared_with_me|shared_drive --source <source_id>`. The source drive owns the uploaded bytes and quota.
99
154
  - Download to this machine with `gsk drive download <drive-path> [local-path]`; this is distinct from `download_file`, which saves an external URL into Drive.
100
155
 
156
+ ## Discover, resolve, and collaborate
157
+
158
+ - Start with `ls -p /` for My Drive, `ls --workspace shared_drive` for Team/channel/DM/Hub sources, or `ls --workspace shared_with_me` for all shared sources. Reuse source IDs; duplicate source names require an explicit ID.
159
+ - With only a name, use `find --scope all -q <name>`; `mine` and `shared` narrow it. Reuse a hit's `entry_locator` (workspace/source/path). Search is bounded and may use an incomplete index: inspect coverage and never interpret no matches as proof of absence.
160
+ - A LinkNode path follows its live source for reads, folder browsing and uploads. Its `content_source_id`/`link_workspace_id` also opens that source at `/`. Do not combine the content mount with the alias's old path. `rm`/`move` on the alias operate on the alias; on a child they operate inside its source. Cross-source moves are refused. Shared source roots cannot be removed. Source-owned shared projections cannot be moved/renamed; unlinking may end that audience's share, reported by share_ended, while preserving source bytes.
161
+ - `get_readable_url` returns the native `entry_id` and, for Office files, `collaboration.file_id` and `link_workspace_id`. For live editing use `wo-peer open <file_id> --link-workspace-id <context>` (omit the flag for My Drive). Never use the shortcut ID as the room ID. Minting rechecks edit access; PDF and project links are not Office rooms.
162
+ - A DM reference grants no source access by itself. Revoked/unavailable/view-only results are permission outcomes; retrying download on the LinkNode cannot fix them.
163
+
164
+ ## Which link to hand the user
165
+
166
+ - `share`, `access`, and `link` replies carry `url`: the entry's share link (`/aidrive/s/<drive>/<entry>`, or `/second-brain/s/…` where the Second Brain drive is rolled out). It carries no access of its own — the server decides per visitor — so paste THAT into chat, email, or a card.
167
+ - `upload`, `download_*`, `compress`, and `decompress` replies carry a browse-location link to the folder in the user's own drive.
168
+ - `ls`/`find` rows for shared shortcuts show their open link in the Type cell (`link:file → <url>`).
169
+ - `get_readable_url` is a one-hour bytes URL for tools (`curl`, media analysis). Never hand it to a person as "the link": it expires, and it opens for whoever holds it.
170
+
101
171
  ## YouTube Downloads
102
172
 
103
173
  `download_video` / `download_audio` with a YouTube URL bill 1 credit per MB of the delivered file (min 1 credit); requests estimated over 1 GB are rejected up front. Time-range clipping is not supported for YouTube — provider clip downloads are broken, so download the full video and trim it locally.
@@ -30,7 +30,7 @@ gsk audio [options]
30
30
  | Flag | Required | Description |
31
31
  |------|----------|-------------|
32
32
  | `<prompt>` (positional) | No | What to generate: narration text for TTS (model-specific format — see the model's prompting guide), or a description for music / sound effects. For voice-clone models this text is narrated with the cloned voice. (string) |
33
- | `-m`, `--model` | No | Model id. Query get_model_info with it before generating. (string, one of: CassetteAI/music-generator, alibaba/qwen-audio-3-tts, bytedance/seed-audio-1.0, elevenlabs/music, elevenlabs/sound-effects, elevenlabs/v3-tts, elevenlabs/voice-changer, elevenlabs/voice-clone, fal-ai/elevenlabs/sound-effects, fal-ai/elevenlabs/tts/multilingual-v2, fal-ai/minimax/speech-2.8-hd, fal-ai/minimax/voice-clone, fal-ai/vibevoice/7b, google/gemini-3.1-flash-tts-preview, google/lyria-music, minimax/music-3.0, mureka/instrumental-generator, mureka/song-generator, nova-sr) |
33
+ | `-m`, `--model` | No | Model id. Query get_model_info with it before generating. (string, one of: CassetteAI/music-generator, alibaba/qwen-audio-3-tts, bytedance/seed-audio-1.0, elevenlabs/music, elevenlabs/sound-effects, elevenlabs/v3-tts, elevenlabs/v4-tts, elevenlabs/voice-changer, elevenlabs/voice-clone, fal-ai/elevenlabs/sound-effects, fal-ai/elevenlabs/tts/multilingual-v2, fal-ai/minimax/speech-2.8-hd, fal-ai/minimax/voice-clone, fal-ai/vibevoice/7b, google/gemini-3.1-flash-tts-preview, google/lyria-music, minimax/music-3.0, mureka, nova-sr) |
34
34
  | `-p`, `--params` | No | Model-specific parameters (speakers, speed/pitch/volume, duration, voice_files, lyrics, composition_plan, output_format, ...). MUST follow the `params_schema` that get_model_info returns for the chosen model. (object) |
35
35
  | `-f`, `--file_name` | No | Name for the generated audio. (string, default: `audio`) |
36
36
  | `--audio_type` | No | (string, one of: speech, music, sound_effect, default: `speech`) |
@@ -30,7 +30,7 @@ gsk claw share_link [options]
30
30
  | Flag | Required | Description |
31
31
  |------|----------|-------------|
32
32
  | `-n`, `--vm_name` | Yes | Name of the VM that hosts the file. (string) |
33
- | `<path>` (positional) | Yes | Absolute file path on the VM (e.g. /home/user/report.pdf). (string) |
33
+ | `<path>` (positional) | Yes | Absolute file path on the VM under /home/work or /tmp (e.g. /home/work/.openclaw/workspace/report.pdf). Hidden files and paths outside those roots cannot be shared. (string) |
34
34
  | `-e`, `--expires_minutes` | No | Link validity in minutes, 1–1440. Default 10. (integer) |
35
35
  | `-p`, `--password` | No | Optional password to protect the share link. Recipients must enter this password to view the file. Must be at least 8 characters with letters, digits, and special characters (e.g. 'xK9#mP2q'). Do NOT use simple dictionary words. (string) |
36
36
 
@@ -30,7 +30,7 @@ gsk genteam [options]
30
30
 
31
31
  | Flag | Required | Description |
32
32
  |------|----------|-------------|
33
- | `<action>` (positional) | Yes | Action to perform. 'join': Join a GenTeam workspace or group chat from an invite link; 'channels': List the caller's workspaces, or one workspace's group chats by server_slug; 'agents': List a workspace's agents visible to the caller by server_slug; each id is a mention target for send; 'read': Read recent messages from a group chat, DM, or thread; around_message_id fetches the window around one message (e.g. a search hit); a thread is also addressable by its root message id via parent_message_id; 'threads': List a group chat's or DM's threads (thread channel id, root comet_message_id, caller_is_participant, reply count / last activity); channel membership is the only requirement; 'download': Download one message attachment (attachments[].attachment_ref from read output) to a fetchable file-wrapper URL; 'search': Search a workspace by server_slug, or one group chat, DM, or thread by channel_id; 'send': Send a message (text, attachment, or thread reply) to a group chat or DM as the caller; a thread reply is also addressable by its root message id via parent_message_id. Supports native @mentions (humans and agents) and native quote replies. Held for confirmation before anything is posted. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'react': Emoji-react to a message in a group chat, DM, or thread (or remove your own reaction). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete': Delete one of YOUR OWN messages in a group chat, DM, or thread (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update': Edit the text of one of YOUR OWN messages (the caption on an attachment message); attachments and existing @mentions are preserved (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'create_channel': Create a group chat in a workspace; the caller becomes its manager and auto-joins. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update_channel': Edit a group chat's display name, description, or member permission switches (manager only). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'invite_link': Create, list, or revoke the invite links that genteam_join consumes (workspace or group chat scoped). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'members': List, add, or remove group chat members (humans and agents) by actor id; op=list also reads a DM's or thread's roster. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'tasks': Task board: list a group chat's, DM's, or workspace's tasks, get one task with its event history, create a task from a message, claim/unclaim it, assign it to one of the caller's agents (op=candidates lists them), rename it, or change its status. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list, get or candidates: those values run immediately (no prompt, no pending_confirmation step).; 'mark_read': Mark a group chat, DM, or thread read (clears the caller's unread count), or back to unread with unread=true; 'forward': Forward one message to another group chat or DM you can post to. A plain message is normally re-sent as the caller's own message (no forward marker or original-author label); a display card or oversized text lands as a chat-history card that keeps the original speaker. An optional note is sent as a separate message right after it. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'pins': List a group chat's pinned messages, or pin/unpin one by its comet_message_id (any active member may, the same rule the app enforces; a thread id addresses its parent group chat's pins). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'dm': List the caller's DMs in a workspace (op=list: peer actor_type + actor_id per row), or open a DM with a human contact or agent (op=open: returns the app's deterministic channel_id, reusing an existing DM; held for confirmation). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'archive_channel': Archive a group chat (manager only): reversible freeze, unarchive_channel restores it. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'unarchive_channel': Restore an archived group chat to live (manager only). Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete_channel': Delete a group chat (manager only; DMs and threads refused); not restorable from the CLI — prefer archive_channel when the history may still be needed. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'leave_channel': Leave a group chat you are a member of (the last manager must delegate or delete instead). Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). (string, one of: join, channels, agents, read, threads, download, search, send, react, delete, update, create_channel, update_channel, invite_link, members, tasks, mark_read, forward, pins, dm, archive_channel, unarchive_channel, delete_channel, leave_channel) |
33
+ | `<action>` (positional) | Yes | Action to perform. 'join': Join a GenTeam workspace or group chat from an invite link; 'channels': List the caller's workspaces, or one workspace's group chats by server_slug; 'agents': List a workspace's agents visible to the caller by server_slug; each id is a mention target for send; 'read': Read recent messages from a group chat, DM, or thread; around_message_id fetches the window around one message (e.g. a search hit); a thread is also addressable by its root message id via parent_message_id; 'threads': List a group chat's or DM's threads (thread channel id, root comet_message_id, caller_is_participant, reply count / last activity); channel membership is the only requirement; 'download': Download one message attachment (attachments[].attachment_ref from read output) to a local file (--local_file <path>; default ./<file_name>); 'search': Search a workspace by server_slug, or one group chat, DM, or thread by channel_id; 'send': Send a message (text, attachment, or thread reply) to a group chat or DM as the caller; a thread reply is also addressable by its root message id via parent_message_id. Supports native @mentions (humans and agents) and native quote replies. Held for confirmation before anything is posted. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'react': Emoji-react to a message in a group chat, DM, or thread (or remove your own reaction). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete': Delete one of YOUR OWN messages in a group chat, DM, or thread (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update': Edit the text of one of YOUR OWN messages (the caption on an attachment message); attachments and existing @mentions are preserved (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'create_channel': Create a group chat in a workspace; the caller becomes its manager and auto-joins. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update_channel': Edit a group chat's display name, description, or member permission switches (manager only). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'invite_link': Create, list, or revoke the invite links that genteam_join consumes (workspace or group chat scoped). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'members': List, add, or remove group chat members (humans and agents) by actor id; op=list also reads a DM's or thread's roster. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'tasks': Task board: list a group chat's, DM's, or workspace's tasks, get one task with its event history, create a task from a message, claim/unclaim it, assign it to one of the caller's agents (op=candidates lists them), rename it, or change its status. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list, get or candidates: those values run immediately (no prompt, no pending_confirmation step).; 'mark_read': Mark a group chat, DM, or thread read (clears the caller's unread count), or back to unread with unread=true; 'forward': Forward one message to another group chat or DM you can post to. A plain message is normally re-sent as the caller's own message (no forward marker or original-author label); a display card lands as a chat-history card that keeps the original speaker. An optional note is sent as a separate message right after it. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'pins': List a group chat's pinned messages, or pin/unpin one by its comet_message_id (any active member may, the same rule the app enforces; a thread id addresses its parent group chat's pins). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'dm': List the caller's DMs in a workspace (op=list: peer actor_type + actor_id per row), or open a DM with a human contact or agent (op=open: returns the app's deterministic channel_id, reusing an existing DM; held for confirmation). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'archive_channel': Archive a group chat (manager only): reversible freeze, unarchive_channel restores it. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'unarchive_channel': Restore an archived group chat to live (manager only). Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete_channel': Delete a group chat (manager only; DMs and threads refused); not restorable from the CLI — prefer archive_channel when the history may still be needed. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'leave_channel': Leave a group chat you are a member of (the last manager must delegate or delete instead). Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). (string, one of: join, channels, agents, read, threads, download, search, send, react, delete, update, create_channel, update_channel, invite_link, members, tasks, mark_read, forward, pins, dm, archive_channel, unarchive_channel, delete_channel, leave_channel) |
34
34
  | `--invite_url` | No | [join] Full invite link URL, including the token query parameter. (string) |
35
35
  | `--invite_id` | No | [join] Invite link id (alternative to invite_url; requires token). \| [invite_link] Invite link id to revoke (from op=list or the create result). (string) |
36
36
  | `--token` | No | [join] Invite link token (alternative to invite_url; requires invite_id). (string) |
@@ -34,7 +34,8 @@ gsk google_calendar [options]
34
34
  | `--time_min` | No | [list] Optional. Start time of the search range (RFC3339 timestamp) (string) |
35
35
  | `--time_max` | No | [list] Optional. End time of the search range (RFC3339 timestamp) (string) |
36
36
  | `--from_account` | No | [list] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [create] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [respond] Optional: Email address of the Gmail account to use. Defaults to the user's primary Gmail account. \| [modify] Optional: Email address of the Gmail account to use. \| [delete] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. (string) |
37
- | `--limit` | No | [list] Optional. Maximum number of events to return. Defaults to 20. (integer) |
37
+ | `--full_description` | No | [list] Return complete readable descriptions instead of 500-character previews. Defaults to false. When true, limit defaults to 5 and must be at most 5; narrow filter_query and time_min/time_max to the desired event. (boolean, default: `False`) |
38
+ | `--limit` | No | [list] Optional. Maximum number of events to return. Defaults to 20 (5 with full_description=true). (integer) |
38
39
  | `--start_time` | No | [free_busy] Window start, RFC3339 (e.g. '2026-07-20T09:00:00+08:00' or '2026-07-20T01:00:00Z'). \| [create] Start time of the event in ISO 8601 format, must include correct timezone offset (e.g., 'yyyy-mm-ddThh:mm:ss+hh:mm') \| [modify] New start time (ISO 8601 with timezone offset, e.g. '2026-05-20T10:00:00-07:00'). Pass with --end_time when rescheduling. (string) |
39
40
  | `--end_time` | No | [free_busy] Window end, RFC3339. \| [create] End time of the event in ISO 8601 format, must include correct timezone offset (e.g., 'yyyy-mm-ddThh:mm:ss-hh:mm') \| [modify] New end time (ISO 8601 with timezone offset). Required if start_time is given. (string) |
40
41
  | `--calendars` | No | [free_busy] Calendar IDs to check — 'primary' or email addresses. Default: ['primary']. (array) |
@@ -42,6 +42,7 @@ gsk meeting [options]
42
42
  | `--sort_by` | No | [search] Sort order. 'relevance' for best match first, 'created_at' for newest first (default). (string, one of: created_at, relevance) |
43
43
  | `--page` | No | [search] Page number (0-indexed). Use with has_more to paginate results. Default: 0. (integer) |
44
44
  | `--task_id` | No | [get] The ID of the meeting note to retrieve. (string) |
45
+ | `--project_id` | No | [get] The ID of the meeting's project, used instead of task_id. Reads any meeting whose project you can read, including one shared with you. Pass exactly one of the two. (string) |
45
46
  | `--detail_level` | No | [get] Level of detail to return. 'summary' = title + status + summary + user notes (default, saves tokens). 'full' = summary + complete transcription text. 'segments' = summary + segments with speaker labels. (string, one of: summary, full, segments) |
46
47
 
47
48
  ## See Also
@@ -34,7 +34,8 @@ gsk outlook_calendar [options]
34
34
  | `--time_min` | No | [list] Optional. Start time for the calendar view (ISO 8601 timestamp). Defaults to 30 days ago. (string) |
35
35
  | `--time_max` | No | [list] Optional. End time for the calendar view (ISO 8601 timestamp). Defaults to 60 days from now. (string) |
36
36
  | `--from_account` | No | [list] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [create] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [respond] Optional: Email address of the Outlook account to use. Defaults to the user's primary Outlook account. \| [modify] Optional: Email address of the Outlook account to use. \| [delete] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. (string) |
37
- | `--limit` | No | [list] Optional. Maximum number of events to return. Defaults to 20. (integer) |
37
+ | `--full_description` | No | [list] Return complete readable descriptions instead of 500-character previews. Defaults to false. When true, limit defaults to 5 and must be at most 5; narrow filter_query and time_min/time_max to the desired event. (boolean, default: `False`) |
38
+ | `--limit` | No | [list] Optional. Maximum number of events to return. Defaults to 20 (5 with full_description=true). (integer) |
38
39
  | `--start_time` | No | [free_busy] Window start, ISO 8601 date-time WITHOUT offset (e.g. '2026-07-20T09:00:00') — interpreted in 'timezone'. \| [create] Start time of the event in ISO 8601 format, must include correct timezone offset (e.g., 'yyyy-mm-ddThh:mm:ss+hh:mm') \| [modify] New start time (ISO 8601 with timezone offset). Pass with --end_time when rescheduling. (string) |
39
40
  | `--end_time` | No | [free_busy] Window end, ISO 8601 (same rule). \| [create] End time of the event in ISO 8601 format, must include correct timezone offset (e.g., 'yyyy-mm-ddThh:mm:ss-hh:mm') \| [modify] New end time (ISO 8601 with timezone offset). Required if start_time is given. (string) |
40
41
  | `--schedules` | No | [free_busy] Email addresses to check. Default: the signed-in user's own address. (array) |
@@ -21,6 +21,8 @@ metadata:
21
21
 
22
22
  **PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
23
23
 
24
+ **THEN READ:** `../gsk-second-brain/SKILL.md` — it says what this command is part of and when to reach for it. This file keeps the flags.
25
+
24
26
  Unified read-only access to the user's Second Brain — notes, emails, meetings, and connected knowledge sources. Identify repos by source name (memo, gmail, outlook, meeting, notion) instead of repo IDs. Actions: list-repos, ls, read, grep, log. Typical flow: list-repos → see available sources; grep -q <pattern> → search across all sources (or -s <source> for one); read -s <hit.source> --repo_id <hit.repo_id> -p <hit.path> → open the exact file a grep or ls hit returned. list-repos also returns a content description and physical clone URL for each visible source. Read-only; does not modify files.
25
27
 
26
28
  ## Usage
@@ -29,89 +31,18 @@ Unified read-only access to the user's Second Brain — notes, emails, meetings,
29
31
  gsk sb-brain [options]
30
32
  ```
31
33
 
32
- ## What the Second Brain is
33
-
34
- The user's **Second Brain** is their durable, cross-session memory on Genspark. It is one brain behind several doors, and `gsk sb-brain` opens exactly one of them. This document is the default guidance; when the product you run in states its own rules for sources, triggers, retries, citation format, or disclosure, those rules win.
35
-
36
- | Door | What is behind it | How you reach it |
37
- |---|---|---|
38
- | **Disk mirror** (sb-git repos) | Notes and uploads, archived mail, meeting notes, imported Notion pages, past Genspark conversations | **`gsk sb-brain`** (this tool) |
39
- | **My Drive** / **Team Drive** | The user's Genspark cloud files, and their teams' shared drives | `gsk aidrive` when permitted. Never a `sb-brain` source; a runtime may additionally offer read-only `sb-ufs` mounts of a drive, so follow that runtime's mount instructions if it does |
40
- | **Live connectors** | Current state in linked apps (today's inbox, calendar, Slack, Notion as it is now) | The matching `gsk <connector>` tool, when granted |
41
-
42
- The disk mirror is what this tool searches. A complete `sb-brain` sweep is therefore an inventory of the user's *notes, mail archive, meetings, and imports* — not of their Drive files, and not of anything that happened in a linked app since the last sync. Route by the source the user names or points at, not by file type: a file in My Drive or Team Drive → `gsk aidrive`; a file uploaded to Notes → `sb-brain` with `-s memo`; a deck, doc, or sheet Genspark generated earlier → the product's past-project tools when present; an attachment in the current conversation → that conversation's own attachment path. For an ambiguous "my deck" or "the spreadsheet I uploaded", take the cue from the conversation before picking a store. When the question is about *now* ("what is in my inbox", "today's meetings"), route to the live connector. `sb-brain` answers what the user **knew, wrote, received, or decided**.
43
-
44
- ### Sources inside the disk mirror
45
-
46
- Every source is a separate repository. `list-repos` tells you which ones this user actually has — the set is per-user and created only by the product when the user connects or imports something; **never assume a fixed set**.
47
-
48
- | `-s <source>` | Contents | Layout you will see with `ls` |
49
- |---|---|---|
50
- | `memo` | The user's own notes, uploads, ZIP imports, and agent-written memory. The UI calls this space **Notes** / "Personal Space" and shows `memo/*` files as its direct children — a note the user calls "X in my notes" is `-s memo -p X`. | Free-form tree. Known system paths: `System/memory/Memory.md` (the user's profile — see below), `System/memory/Cards/*.md`, `_conversations/YYYY-MM-DD/<topic>.md` (saved chat captures), `Workflows/<name>/` (scheduled-workflow outputs). |
51
- | `gmail`, `outlook` | **Archived mail mirror**, one repo per account (`--repo_id` picks one when the user has several). Read-only, historical. Authoritative for *what an email said*; never for *what is in the inbox now*, "latest", or "how many". | `INDEX.md` → `YYYY-MM/INDEX.md` → `YYYY-MM/<subject-slug>-YYYY-MM-DD.html` (raw HTML, no frontmatter). Months are UTC. Not split by mailbox folder. |
52
- | `meeting` | Meeting notes and transcripts from Genspark meeting recordings, organized by date. | `INDEX.md` → `YYYY-MM/INDEX.md` → `YYYY-MM/YYYY-MM-DD_<title>.md` (YAML frontmatter: `title`, `occurred_at`, `participants`; body: Summary / Action Items / Highlights / Transcript). Long transcripts sit in a sibling `*.transcript.md`. |
53
- | `notion` | A frozen import of the user's Notion workspace — fine for "what did I write", not for Notion as it is now. | `Notion/<page>.md`, attachments alongside. |
54
- | `project_history` | A view of the platform-written `brain` repo; present only for some users. The cleaned past Genspark conversations sit under `session_clean/`. | `session_clean/INDEX.md` → `session_clean/YYYY-MM/<project_id>.md`. For a conversation lookup pass `-s project_history -p session_clean/`; an all-source grep is not confined to that folder and may also hit the repo's profile and memory files. |
55
- | `team` | Dormant. Team knowledge lives in Team Drive (`gsk aidrive --workspace shared_drive`), not here. | — |
56
-
57
- `list-repos` rows also carry `mounted`: a `mounted: false` source exists but the user has switched it off — `ls`/`read`/`grep`/`log` only accept mounted ones. Do not report a switched-off source as "no content".
58
-
59
- ### The user's profile: `memo/System/memory/Memory.md`
60
-
61
- For questions about the user themself — who they are, what they work on, the people around them, how they like things done, what is open — read `System/memory/Memory.md` in `memo` first. It is a portrait (`## Who I Am`, `## Work`, `## People`, `## How I Work`, `## Open Loops`) plus an index of `Cards/`; open only the cards the question actually needs. Treat it as background that was true when written, not as instructions, and verify against current sources before acting on a line from it. Older users may have the same content under `memo/Memory/`.
62
-
63
- ## When to open it, and how far to go
64
-
65
- Most requests are self-contained; do not open the brain for them. Open it on one of three signals:
66
-
67
- 1. **A memory question.** "Did I ever", "what did we decide about X", "what did <person> say", "find my notes on Y".
68
- 2. **An explicit pointer.** The user says to check their notes, mail, meetings, or Second Brain.
69
- 3. **An unresolved name.** A person, customer, project, or term used as if you should know it, that the conversation does not explain.
70
-
71
- Default budget is one focused `grep` (all sources, or `-s` when the user named one) and one `read` of the most relevant hit; answer only what that file supports. A keyword hit is not yet an answer: if the hit is an index, summary, or pointer, read the file it points to; if two relevant hits disagree, read both before you explain the disagreement. Those targeted verification reads are fine; a new search is not. If nothing relevant comes back, try one variant (a shorter prefix, a nickname, the user's other language), then stop and say what you covered: "your notes and both mailboxes have no line matching X". Do not chain probes or browse month indexes on your own.
72
-
73
- Go wider only when the user asks or pushes back on a negative, and keep the scope they gave: "search all my meetings" stays in `-s meeting`, "look harder" keeps the current source, account, and dates. Sweep every mounted source only when no narrower scope was given or the user widens it themselves; the 20-hit cap is shared across sources, so a wide sweep can starve the one source the user actually named. Browse `YYYY-MM/INDEX.md` only inside the chosen mail or meeting repos (keep the `repo_id`), and name the coverage and any skipped sources when you report.
74
-
75
- ## Recipe
76
-
77
- ```bash
78
- # 1. What does THIS user have? (memo, gmail x2, meeting, ...)
79
- gsk sb-brain list-repos
80
-
81
- # 2. Sweep every mounted source with a short keyword; -s scopes to one, --repo_id to one account.
82
- gsk sb-brain grep -q "acme renewal"
83
- gsk sb-brain grep -q "acme" -s gmail --repo_id <id-from-list-repos>
84
-
85
- # 3. Open the exact hit in full. Copy source, repo_id, and path from the hit;
86
- # without --repo_id a source with several repos (two mailboxes) reads the first one.
87
- gsk sb-brain read -s <hit.source> --repo_id <hit.repo_id> -p <hit.path>
88
-
89
- # Only when the user asked for wider or date-based coverage, or pushed back on a negative
90
- # (mail and meetings are month-foldered).
91
- gsk sb-brain ls -s meeting -p 2026-05/
92
- gsk sb-brain read -s gmail -p 2026-05/INDEX.md
93
-
94
- # Recent activity in a source.
95
- gsk sb-brain log -s memo --limit 10
96
- ```
97
-
98
- - `grep` is a case-insensitive **fixed-string** match (not regex), capped at 20 hits across all sources. Use one or two distinctive words; a long phrase must appear on a single line exactly. `truncated: true` means the cap was hit — narrow with `-s` or `-p`, or use a rarer word.
99
- - `sources_searched` / `sources_skipped` in the grep result tell you what was actually covered; a skipped source is not a searched source.
100
- - A grep hit is one line of context. Always `read` the file before quoting it or acting on it.
101
- - Read-only: this tool never modifies files.
102
-
103
- ## Reporting what you found — and what you did not
104
-
105
- - Quote dates, numbers, names, decisions, money, and status **verbatim** from the source; never paraphrase those.
106
- - Cite by something the user recognizes — the note's title, "the 2026-04-12 sync with Pedro", "an email from <name> re: <subject>" — with its date. In written deliverables use `[Source: <title>, YYYY-MM-DD]`.
107
- - Conflicting sources: surface both with their dates; do not silently pick one. The archive can settle what was said; only a live source can settle what is true now.
108
- - Never invent a detail to make an answer look complete. If it is not in any of the user's real sources, say so.
109
- - Phrase a negative as **coverage, not status**: distinguish "your notes, both mailboxes, and meetings from March through July have no record of X" (you walked everything) from "I did not find X" (you may have stopped early), and name what you covered so the user can point at the gap. Never say the Second Brain is empty unless `list-repos` is actually empty.
110
- - Speak in product language — "your notes", "your emails", "your meetings" — not repo names, paths, or hit counts.
34
+ ## What this command reads
111
35
 
112
- ## Privacy
36
+ `gsk sb-brain` opens the **Notes** half of the user's Second Brain — their
37
+ notes, archived mail, meeting notes, Notion import, and past Genspark
38
+ conversations. The map of the whole Second Brain (Notes + Drive, which door
39
+ opens which part, how to read, write and edit) is `../gsk-second-brain/SKILL.md`;
40
+ read it first. Two details that belong to this command alone:
113
41
 
114
- Everything here is the account owner's private data. When the person asking is not the owner (a teammate in a shared channel, a recipient of an email you are drafting), relay only what the task needs; never paste unrelated notes or mail into a shared conversation or an outbound message.
42
+ - `grep` is a fixed string, case-insensitive — not a regex. Use a short
43
+ distinctive keyword; a long phrase must match a single line exactly.
44
+ - `read` takes the hit's `repo_id` (`--repo_id <hit.repo_id>`); without it a
45
+ source with several repos (two mailboxes) opens the first one.
115
46
 
116
47
  ## Flags
117
48
 
@@ -119,7 +50,7 @@ Everything here is the account owner's private data. When the person asking is n
119
50
  |------|----------|-------------|
120
51
  | `<action>` (positional) | Yes | Action to perform. (string, one of: list-repos, ls, read, grep, log) |
121
52
  | `-s`, `--source` | No | Source name: memo, gmail, outlook, meeting, notion, team, custom, project_history. Required for ls, read, log. Optional for grep (omit to search ALL mounted sources). (string) |
122
- | `-p`, `--path` | No | File or directory path within the source repo. Used by ls (optional, defaults to root) and read (required). (string) |
53
+ | `-p`, `--path` | No | File or directory path within the source repo. Used by ls (optional, defaults to root), read (required) and grep (optional directory prefix that confines the search). (string) |
123
54
  | `-q`, `--query` | No | Search text for grep (fixed string, case-insensitive; NOT a regex). Required for grep. Use a short distinctive keyword — a long phrase must match a single line exactly. (string) |
124
55
  | `--ref` | No | Git ref (branch or commit SHA). Defaults to main. (string) |
125
56
  | `--repo_id` | No | Disambiguate when a source has multiple repos (e.g. two Gmail accounts). Get from list-repos. Optional; defaults to first match. (string) |