@giftsofprometheus/cli 0.7.3 → 0.8.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.
package/README.md CHANGED
@@ -49,6 +49,8 @@ giftsofprometheus feed # подборка по ва
49
49
 
50
50
  Для транскриптов, избранного и ленты нужен бесплатный аккаунт: [войдите на сайте](https://giftsofprometheus.com/login?utm_source=github&utm_medium=readme&utm_campaign=cli) по ссылке из письма, без пароля. `login` подключает к этому аккаунту устройство через подтверждение в браузере, токены копировать не нужно. Сессия живёт 30 дней и хранится в `$XDG_CONFIG_HOME/giftsofprometheus/credentials.json` (по умолчанию `~/.config/giftsofprometheus/`), читать её можете только вы. В [кабинете](https://giftsofprometheus.com/account?utm_source=github&utm_medium=readme&utm_campaign=cli) видны все подключённые устройства, любое можно отключить. `giftsofprometheus logout` отключает текущее.
51
51
 
52
+ В той же папке лежит `client.json` со случайным идентификатором установки. CLI отправляет его заголовком `X-Client-Id`, чтобы сервис считал запросы без входа одним клиентом в аналитике. С аккаунтом он не связан, удалите файл, чтобы получить новый.
53
+
52
54
  ## Для AI-агентов: Claude Code, Codex, Cursor
53
55
 
54
56
  В репозитории есть skill: он объясняет агенту, когда и как пользоваться CLI. Поставить его можно через [skills](https://skills.sh):
@@ -109,7 +111,7 @@ npx skills add giftsofprometheus/giftsofprometheus-cli
109
111
 
110
112
  ## Команды
111
113
 
112
- С флагом `--json` любая команда печатает компактный JSON. Ошибка тогда выглядит как `{"error":{"message","status","code","nextStep"}}`, а код выхода — 1: `code` и `nextStep` приходят от сервиса, когда он их знает. После обрыва соединения или ответа 502, 503 или 504 от прокси CLI сам повторяет запрос два раза.
114
+ Без флагов команды печатают текст для человека: списки докладов с номерами и ссылками, транскрипт с главами и таймкодами, подсказку со следующей командой. С флагом `--json` любая команда печатает компактный JSON: так CLI вызывают агенты. Ошибка тогда выглядит как `{"error":{"message","status","code","nextStep"}}`, а код выхода — 1: `code` и `nextStep` приходят от сервиса, когда он их знает. После обрыва соединения или ответа 502, 503 или 504 от прокси CLI сам повторяет запрос два раза.
113
115
 
114
116
  | Команда | Что делает | Аккаунт |
115
117
  |---|---|---|
@@ -118,18 +120,22 @@ npx skills add giftsofprometheus/giftsofprometheus-cli
118
120
  | `talks list [--page n]` | Каталог по страницам | |
119
121
  | `talks get <slug-или-id>` | Доклад с описанием, спикерами (компания и должность), темами и видео | |
120
122
  | `talks content <slug-или-id> [--rec-id UUID] [--from время] [--to время] [--outline]` | Транскрипт на языке доклада: целиком, отрезок (`--from 12:30 --to 18:00`) или только спикеры и главы (`--outline`) | ✓ |
123
+ | `talks similar <slug-или-id>` | До четырёх похожих докладов, у каждого причина | |
124
+ | `talks react <slug-или-id> like\|dislike\|not-interested\|clear [--rec-id UUID]` | Отметить, понравился ли доклад; учитывается в подборке | ✓ |
121
125
  | `favorites list [--page n] [--limit n]` | Ваше избранное | ✓ |
122
126
  | `favorites add <slug-или-id>` / `remove` | Добавить в избранное или убрать | ✓ |
123
127
  | `profile get` | Ваши интересы и текущая задача | ✓ |
124
128
  | `profile update [--interest тема=уровень] [--remove-interest тема] [--query-text текст]` | Изменить интересы (`high`, `interested`, `not_interested`) или текущую задачу; остальное не меняется | ✓ |
125
129
  | `feed` | Подборка по вашему профилю | ✓ |
126
- | `request <путь>` | GET-запрос только на чтение к `/api/knowledge/…` или `/api/account/…` | ✓ |
130
+ | `request <путь>` | GET-запрос только на чтение к `/api/knowledge/…` или `/api/account/…`; печатает ответ сервиса как JSON | ✓ |
127
131
  | `onboarding topics` | Темы для выбора интересов | |
128
132
  | `onboarding deck [--interest тема=уровень] [--query-text текст]` | Новый черновик по темам (`interested`, `not_interested`) и до 8 пронумерованных докладов для оценки | |
129
133
  | `onboarding react <номер>=like\|dislike\|skip…` | Оценить доклады из колоды по номерам и получить рекомендации, к которым они ведут | |
130
134
  | `onboarding finish [--query-text текст]` | Сохранить черновик в аккаунт | ✓ |
131
135
  | `login [--start\|--wait]`, `logout`, `whoami`, `doctor` | Вход, выход, текущий аккаунт, проверка настройки. `login --start` сразу печатает ссылку и код, `login --wait` ждёт подтверждения | |
132
136
  | `skill [--path]` | Skill для агента | |
137
+ | `skill update [--force]` | Обновить установленные копии skill до версии CLI | |
138
+ | `skill personalize --file <путь>` | Добавить ваши темы в описание skill | ✓ |
133
139
 
134
140
  ## Настройки
135
141
 
@@ -137,6 +143,7 @@ npx skills add giftsofprometheus/giftsofprometheus-cli
137
143
  |---|---|---|
138
144
  | `GIFTSOFPROMETHEUS_URL` | `https://giftsofprometheus.com` | Адрес сервиса. HTTP без TLS разрешён только для `localhost` |
139
145
  | `XDG_CONFIG_HOME` | `~/.config` | Где хранится сессия; относительный путь игнорируется |
146
+ | `NO_COLOR` | не задана | Любое значение отключает жирный и приглушённый текст в выводе |
140
147
 
141
148
  ## Разработка
142
149
 
package/dist/index.js CHANGED
@@ -9,6 +9,8 @@ import { randomUUID } from 'node:crypto';
9
9
  import { createRequire } from 'node:module';
10
10
  import { fileURLToPath } from 'node:url';
11
11
  import { mergeSkill, newerVersion, personalDescription, skillDescription, skillHash, tailTopics } from './skill-files.js';
12
+ import * as text from './render.js';
13
+ import { printable } from './render.js';
12
14
  const { version } = z.object({ version: z.string() }).parse(createRequire(import.meta.url)('../package.json'));
13
15
  const program = new Command();
14
16
  const base = (process.env.GIFTSOFPROMETHEUS_URL || 'https://giftsofprometheus.com').replace(/\/$/, '');
@@ -24,6 +26,29 @@ const pendingLogin = join(directory, 'login.json');
24
26
  const onboardingDraft = join(directory, 'onboarding.json');
25
27
  // When the daily update check last ran and what npm reported then
26
28
  const updateState = join(directory, 'update.json');
29
+ // A random id of this installation, sent as X-Client-Id so the service counts a guest CLI as one client in its analytics
30
+ const clientFile = join(directory, 'client.json');
31
+ let clientId;
32
+ /** Created once; a config folder that cannot be written only drops the header, it never fails a command */
33
+ function installationId() {
34
+ clientId ??= (async () => {
35
+ try {
36
+ const parsed = z.object({ id: z.uuid() }).safeParse(JSON.parse(await readFile(clientFile, 'utf8')));
37
+ if (parsed.success)
38
+ return parsed.data.id;
39
+ }
40
+ catch { }
41
+ const id = randomUUID();
42
+ try {
43
+ await saveJson(clientFile, { id });
44
+ return id;
45
+ }
46
+ catch {
47
+ return null;
48
+ }
49
+ })();
50
+ return clientId;
51
+ }
27
52
  const credentialsSchema = z.object({ base: z.string(), token: z.string() });
28
53
  /** Only a missing file means "no session"; a file that cannot be read or parsed may still hold a valid session */
29
54
  async function storedAny() {
@@ -58,9 +83,6 @@ class ApiError extends Error {
58
83
  this.nextStep = nextStep;
59
84
  }
60
85
  }
61
- // Server text reaches a terminal: remove control characters so a response cannot inject ANSI or OSC escape sequences
62
- // oxlint-disable-next-line no-control-regex -- matching control characters is the purpose of this function
63
- const printable = (value) => value.replace(/[\u0000-\u001f\u007f-\u009f]/g, '');
64
86
  // A fresh 0600 file renamed into place: a secret never lands in an existing file with loose permissions or behind a symlink
65
87
  async function saveJson(file, value) {
66
88
  await mkdir(directory, { recursive: true, mode: 0o700 });
@@ -88,6 +110,8 @@ async function readState(file, schema) {
88
110
  return null;
89
111
  }
90
112
  }
113
+ // Set when a command returns a response it could not check; the text form then shows it as JSON instead of reading it
114
+ let unchecked = false;
91
115
  async function request(path, method = 'GET', body, authenticated = true) {
92
116
  if (!path.startsWith('/') || path.includes('\\'))
93
117
  throw new ApiError(`Invalid API path: pass a full path starting with ${publicApi.join(', ')}, e.g. /api/knowledge/profile`);
@@ -101,6 +125,9 @@ async function request(path, method = 'GET', body, authenticated = true) {
101
125
  const headers = new Headers({ 'Content-Type': 'application/json', 'X-Knowledge-Client': 'agent', 'User-Agent': `giftsofprometheus/${version}` });
102
126
  if (credential)
103
127
  headers.set('Authorization', `Bearer ${credential.token}`);
128
+ const installation = await installationId();
129
+ if (installation)
130
+ headers.set('X-Client-Id', installation);
104
131
  for (let attempt = 1;; attempt++) {
105
132
  let response;
106
133
  try {
@@ -143,17 +170,42 @@ async function request(path, method = 'GET', body, authenticated = true) {
143
170
  // Two repeats after a gateway error or a connection failure: a deploy switch or a dropped keep-alive connection passes in seconds
144
171
  const RETRY_DELAYS_MS = [500, 1500];
145
172
  const GATEWAY_STATUSES = new Set([502, 503, 504]);
146
- function out(value) {
147
- console.log(JSON.stringify(value, null, program.opts().json ? 0 : 2));
173
+ /** A renderer that checks the shape first, so a service change shows the JSON instead of crashing the command */
174
+ const view = (schema, format) => (value, ...args) => {
175
+ const parsed = schema.safeParse(value);
176
+ try {
177
+ return parsed.success ? format(parsed.data, ...args) : null;
178
+ }
179
+ catch {
180
+ return null;
181
+ }
182
+ };
183
+ // Next-step hints go to stderr after the output, so a person reads them last and stdout stays the result
184
+ const hints = [];
185
+ /** `human` replaces the line for a person; null shows nothing, when the text output already says it */
186
+ const hint = (json, human = json) => hints.push({ json, human: human === null ? null : printable(human) });
187
+ // JSON.stringify escapes C0 control characters but not DEL and C1; a person's terminal would interpret those
188
+ // oxlint-disable-next-line no-control-regex -- matching control characters is the purpose of this expression
189
+ const escapeC1 = (json) => json.replace(/[\u007f-\u009f]/g, c => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
190
+ // With --json: one JSON document for agents. Without it: text for a person, or indented JSON where a command has no text form
191
+ function out(value, render, args) {
192
+ const json = program.opts().json;
193
+ console.log(json ? JSON.stringify(value) : ((unchecked ? null : render?.(value, ...args)) ?? escapeC1(JSON.stringify(value, null, 2))));
194
+ for (const line of hints.splice(0)) {
195
+ if (json)
196
+ console.error(line.json);
197
+ else if (line.human !== null)
198
+ console.error(text.dim(line.human));
199
+ }
148
200
  }
149
201
  // What an agent must do on 401. It is in the error itself, so an agent without the skill also knows to sign the user in
150
202
  const SIGN_IN_STEPS = 'Sign the user in: run `login --start` with the same launcher and --json, give the user verificationUrl and userCode in one line, run `login --wait` (it waits for the confirmation), then repeat this command.';
151
203
  const interactive = () => !program.opts().json && Boolean(process.stdin.isTTY && process.stderr.isTTY);
152
- function run(fn) {
204
+ function run(fn, render) {
153
205
  return async (...args) => {
154
206
  try {
155
207
  try {
156
- out(await fn(...args));
208
+ out(await fn(...args), render, args);
157
209
  }
158
210
  catch (e) {
159
211
  // A person in a terminal is taken through the browser confirmation and gets the answer, instead of an error to act on
@@ -162,15 +214,18 @@ function run(fn) {
162
214
  const device = await startLogin();
163
215
  console.error(`Sign-in needed. Open ${verificationUrl(device.userCode)} and confirm the code ${device.userCode}`);
164
216
  await waitLogin(device);
165
- out(await fn(...args));
217
+ console.error(text.signedIn({ signedIn: true }));
218
+ out(await fn(...args), render, args);
166
219
  }
167
220
  }
168
221
  catch (e) {
222
+ hints.length = 0;
169
223
  const message = e instanceof Error ? e.message : 'Unknown error';
170
224
  const status = e instanceof ApiError ? e.status : 1;
171
225
  const code = e instanceof ApiError ? e.code : undefined;
172
- // On 401 the CLI's own steps win: they say how to sign in from an agent, which the service cannot know
173
- const nextStep = status === 401 ? SIGN_IN_STEPS : e instanceof ApiError ? e.nextStep : undefined;
226
+ // On 401 the CLI's own steps win: they say how to sign in from an agent, which the service cannot know. A person runs login
227
+ const signIn = program.opts().json ? SIGN_IN_STEPS : `sign in with ${cmd()} login, then repeat this command`;
228
+ const nextStep = status === 401 ? signIn : e instanceof ApiError ? e.nextStep : undefined;
174
229
  if (program.opts().json)
175
230
  console.log(JSON.stringify({ error: { message, status, ...(code ? { code } : {}), ...(nextStep ? { nextStep } : {}) } }));
176
231
  else {
@@ -195,6 +250,18 @@ const updateCommand = /[\\/]pnpm[\\/]global[\\/]/.test(packageRoot)
195
250
  : /[\\/]\.bun[\\/]install[\\/]global[\\/]/.test(packageRoot)
196
251
  ? 'bun add -g @giftsofprometheus/cli@latest'
197
252
  : 'npm install -g @giftsofprometheus/cli@latest';
253
+ // The command a person typed, so a hint can be pasted back as is
254
+ const detectedLauncher = /[\\/]_npx[\\/]/.test(packageRoot)
255
+ ? 'npx @giftsofprometheus/cli'
256
+ : /[\\/]bunx-[^\\/]*[\\/]/.test(packageRoot)
257
+ ? 'bunx @giftsofprometheus/cli'
258
+ : /[\\/]dlx[\\/]/.test(packageRoot)
259
+ ? 'pnpm dlx @giftsofprometheus/cli'
260
+ : 'giftsofprometheus';
261
+ // --json output keeps the commands it has always named: agents follow them, and the skill says how to run the CLI
262
+ const jsonLauncher = /[\\/]_npx[\\/]/.test(packageRoot) ? 'npx @giftsofprometheus/cli' : 'giftsofprometheus';
263
+ const cmd = () => (program.opts().json ? jsonLauncher : detectedLauncher);
264
+ const context = { launcher: detectedLauncher, base };
198
265
  const shortPath = (path) => (path.startsWith(homedir()) ? '~' + path.slice(homedir().length) : path);
199
266
  async function fetchLatest() {
200
267
  try {
@@ -376,6 +443,8 @@ async function login(options) {
376
443
  return loginPrompt(device);
377
444
  }
378
445
  console.error(`Open ${verificationUrl(device.userCode)} and confirm the code ${device.userCode}`);
446
+ if (!program.opts().json)
447
+ console.error(text.dim('Waiting for the confirmation…'));
379
448
  return waitLogin(device);
380
449
  }
381
450
  async function waitLogin(device) {
@@ -437,7 +506,10 @@ program
437
506
  .description('Authorize this CLI in a browser')
438
507
  .option('--start', 'print the confirmation link and code, then exit; finish with login --wait')
439
508
  .option('--wait', 'wait for the confirmation of a login started with --start')
440
- .action(run(login));
509
+ .action(run(login, value => {
510
+ const prompt = text.loginPromptSchema.safeParse(value);
511
+ return prompt.success ? text.loginPrompt(context, prompt.data) : view(text.signedInSchema, text.signedIn)(value);
512
+ }));
441
513
  program
442
514
  .command('logout')
443
515
  .description('Revoke this CLI session')
@@ -460,11 +532,11 @@ program
460
532
  }
461
533
  await unlink(credentials).catch(() => { });
462
534
  return { signedOut: true };
463
- }));
535
+ }, () => 'Signed out.'));
464
536
  program
465
537
  .command('whoami')
466
538
  .description('Show the current account')
467
- .action(run(() => request('/api/account/me')));
539
+ .action(run(() => request('/api/account/me'), view(text.accountSchema, text.account)));
468
540
  program
469
541
  .command('doctor')
470
542
  .description('Check configuration, server and authorization')
@@ -493,7 +565,7 @@ program
493
565
  skills: skills.map(skill => ({ path: skill.path, status: skill.status, version: skill.version })),
494
566
  nextStep: !reachable ? 'Check GIFTSOFPROMETHEUS_URL and server availability' : !authenticated ? 'Run giftsofprometheus login' : null,
495
567
  };
496
- }));
568
+ }, view(text.doctorSchema, value => text.doctor(context, value))));
497
569
  program
498
570
  .command('ask')
499
571
  .description('Find relevant passages in talk transcripts')
@@ -512,7 +584,7 @@ program
512
584
  if (options.perTalk !== undefined)
513
585
  params.set('perTalk', number.parse(options.perTalk));
514
586
  return request(`/api/knowledge/passages?${params}`);
515
- }));
587
+ }, view(text.passagesSchema, value => text.passages(context, value))));
516
588
  /** The service takes one to three texts of up to 200 characters; a plain message tells an agent what to drop */
517
589
  function askQueries(values) {
518
590
  const queries = values.map(value => value.trim());
@@ -535,10 +607,12 @@ const contentShape = z.object({ transcript: z.array(z.object({ startMs: z.number
535
607
  const talks = program.command('talks').description('Browse talks');
536
608
  talks
537
609
  .command('list')
610
+ .description('List published talks, page by page')
538
611
  .option('--page <page>', 'page number', '1')
539
- .action(run((options) => request(`/api/knowledge/talks?page=${encodeURIComponent(options.page)}`, 'GET', undefined, false)));
612
+ .action(run((options) => request(`/api/knowledge/talks?page=${encodeURIComponent(options.page)}`, 'GET', undefined, false), view(text.pageSchema, value => text.talkPage(context, value, page => `talks list --page ${page}`, 'No talks on this page.'))));
540
613
  talks
541
614
  .command('search')
615
+ .description('Search published talks by title, summary, speaker or topic')
542
616
  .argument('<query>')
543
617
  .option('--page <page>', 'page number', '1')
544
618
  .action(run((query, options) => {
@@ -546,21 +620,24 @@ talks
546
620
  if (!query.trim())
547
621
  throw new ApiError('Empty search query. To browse the catalog, use: giftsofprometheus talks list');
548
622
  return request(`/api/knowledge/talks?q=${encodeURIComponent(query)}&page=${encodeURIComponent(options.page)}`);
549
- }));
550
- // The command a person typed, so a hint can be pasted back as is
551
- const launcher = /[\\/]_npx[\\/]/.test(packageRoot) ? 'npx @giftsofprometheus/cli' : 'giftsofprometheus';
623
+ }, view(text.pageSchema, (value, query) => text.talkPage(context,
624
+ // Search is public: with an expired session the service answers it as anonymous and accepts that recId only from
625
+ // the site, and the response does not say which it was. A person opens a found talk without one
626
+ { ...value, recId: undefined }, page => `talks search --page ${page} -- ${shellQuote(query)}`, `Nothing found. Search the transcripts instead: ${cmd()} ask -- ${shellQuote(query)}`))));
552
627
  talks
553
628
  .command('get')
629
+ .description('Show one talk: summary, speakers, topics and links')
554
630
  .argument('<slug-or-id>')
555
631
  .action(run(async (id) => {
556
632
  const talk = await resolveTalk(id);
557
633
  // The next step after the summary is the transcript; stdout stays the talk's JSON
558
634
  const signedIn = Boolean(await stored());
559
- console.error(`Next: the full transcript — ${launcher} talks content ${talk.slug}${signedIn ? '' : ' (asks you to sign in in the browser first)'}`);
635
+ hint(`Next: the full transcript — ${cmd()} talks content ${talk.slug}${signedIn ? '' : ' (asks you to sign in in the browser first)'}`);
560
636
  return talk;
561
- }));
637
+ }, view(text.talkSchema, value => text.talkDetails(context, value))));
562
638
  talks
563
639
  .command('content')
640
+ .description('Read the transcript with chapters and timestamps; requires login')
564
641
  .argument('<slug-or-id>')
565
642
  .option('--rec-id <recId>', 'recId of the list the talk came from (feed, search or similar)')
566
643
  .option('--from <time>', 'keep transcript segments that start at or after this time: seconds, m:ss or h:mm:ss')
@@ -575,7 +652,13 @@ talks
575
652
  const talk = await resolveTalk(id);
576
653
  const raw = await request(`/api/knowledge/talks/${encodeURIComponent(String(talk.slug))}/content${query}`, 'POST');
577
654
  const whole = !options.outline && options.from === undefined && options.to === undefined;
578
- const content = whole ? null : contentShape.parse(raw);
655
+ const parsed = whole ? null : contentShape.safeParse(raw);
656
+ if (parsed && !parsed.success) {
657
+ if (program.opts().json)
658
+ throw parsed.error;
659
+ unchecked = true;
660
+ }
661
+ const content = parsed?.success ? parsed.data : null;
579
662
  // A range keeps the chapters, so an agent still sees where it is in the talk
580
663
  const result = content === null
581
664
  ? raw
@@ -583,11 +666,12 @@ talks
583
666
  ? { ...content, transcript: undefined, transcriptSegments: content.transcript.length }
584
667
  : { ...content, transcript: content.transcript.filter(segment => segment.startMs >= from && segment.startMs < to) };
585
668
  // After the transcript: talks like this one, or saving it if the user found it useful
586
- console.error(`Next: similar talks — ${launcher} talks similar ${talk.slug}; save it if the user asks — ${launcher} favorites add ${talk.slug}`);
669
+ hint(`Next: similar talks — ${cmd()} talks similar ${talk.slug}; save it if the user asks — ${cmd()} favorites add ${talk.slug}`, `Next: similar talks — ${cmd()} talks similar ${talk.slug}; save to favorites — ${cmd()} favorites add ${talk.slug}${options.recId ? ` --rec-id ${options.recId}` : ''}`);
587
670
  return result;
588
- }));
671
+ }, (value, _, options) => view(options.outline ? text.outlineSchema : text.contentSchema, text.transcript)(value)));
589
672
  talks
590
673
  .command('similar')
674
+ .description('Up to four talks like this one, each with a reason')
591
675
  .argument('<slug-or-id>')
592
676
  .action(run(async (id) => {
593
677
  const talk = await resolveTalk(id);
@@ -597,9 +681,9 @@ talks
597
681
  .loose()
598
682
  .parse(await request(`/api/knowledge/talks/${encodeURIComponent(String(talk.slug))}/similar`));
599
683
  if (result.recId)
600
- console.error(`Next: open one with ${launcher} talks content <slug> --rec-id ${result.recId}`);
684
+ hint(`Next: open one with ${cmd()} talks content <slug> --rec-id ${result.recId}`, null);
601
685
  return result;
602
- }));
686
+ }, view(text.listSchema, value => text.talkList(context, value, 'No similar talks yet.'))));
603
687
  const reactionTypes = { like: 'like', dislike: 'dislike', 'not-interested': 'not_interested', clear: 'clear_reaction' };
604
688
  talks
605
689
  .command('react')
@@ -610,24 +694,30 @@ talks
610
694
  .action(run(async (id, reaction, options) => {
611
695
  const type = z.enum(['like', 'dislike', 'not-interested', 'clear']).parse(reaction);
612
696
  return event(id, reactionTypes[type], options.recId);
613
- }));
697
+ }, (_, id, reaction) => reaction === 'clear' ? `Cleared the reaction to ${printable(id)}.` : `Recorded: ${printable(reaction)} for ${printable(id)}.`));
614
698
  const favorites = program.command('favorites').description('Manage bookmarks');
615
699
  favorites
616
700
  .command('list')
701
+ .description('List saved talks')
617
702
  .option('--page <page>', 'page number', '1')
618
703
  .option('--limit <limit>', 'page size, max 50', '20')
619
- .action(run((o) => request(`/api/knowledge/favorites?page=${encodeURIComponent(o.page)}&limit=${encodeURIComponent(o.limit)}`)));
704
+ .action(run((o) => request(`/api/knowledge/favorites?page=${encodeURIComponent(o.page)}&limit=${encodeURIComponent(o.limit)}`), view(text.pageSchema, (value, o) => text.talkPage(context, value, page => `favorites list --page ${page} --limit ${shellQuote(o.limit)}`, `No favorites yet. Save a talk with: ${cmd()} favorites add <slug>`))));
620
705
  favorites
621
706
  .command('add')
707
+ .description('Save a talk to favorites')
622
708
  .argument('<slug-or-id>')
623
709
  .option('--rec-id <recId>', 'recId of the list the talk came from')
624
- .action(run((id, options) => event(id, 'bookmark', options.recId)));
710
+ .action(run((id, options) => event(id, 'bookmark', options.recId), (_, id) => `Saved ${printable(id)} to favorites.`));
625
711
  favorites
626
712
  .command('remove')
713
+ .description('Remove a talk from favorites')
627
714
  .argument('<slug-or-id>')
628
- .action(run((id) => event(id, 'unbookmark')));
715
+ .action(run((id) => event(id, 'unbookmark'), (_, id) => `Removed ${printable(id)} from favorites.`));
629
716
  const profile = program.command('profile').description('Read or update interests');
630
- profile.command('get').action(run(() => request('/api/knowledge/profile')));
717
+ profile
718
+ .command('get')
719
+ .description('Show interests and the current task')
720
+ .action(run(() => request('/api/knowledge/profile'), view(text.profileSchema, text.profile)));
631
721
  const levels = z.enum(['high', 'interested', 'not_interested']);
632
722
  // The service omits the slug of a deleted topic; such interests are dropped on update
633
723
  const currentProfile = z.object({ interests: z.array(z.object({ topic: z.string().optional(), level: levels })), queryText: z.string() });
@@ -656,7 +746,7 @@ profile
656
746
  .option('--interest <topic=level>', 'set a topic to high, interested or not_interested; repeatable', collect, [])
657
747
  .option('--remove-interest <topic>', 'remove a topic; repeatable', collect, [])
658
748
  .option('--query-text <text>', 'replace the current task; an empty string clears it')
659
- .action(run(updateProfile));
749
+ .action(run(updateProfile, () => `Profile updated. See it with: ${cmd()} profile get`));
660
750
  const draftLevels = z.enum(['interested', 'not_interested']);
661
751
  const reactions = z.enum(['like', 'dislike']);
662
752
  const draftSchema = z.object({
@@ -753,27 +843,27 @@ onboarding
753
843
  .description('List topics to match interests against; no account needed')
754
844
  .action(run(async () => z
755
845
  .object({ topics: z.array(z.object({ slug: z.string(), title: z.string(), section: z.string().nullable() })) })
756
- .parse(await request('/api/knowledge/topics', 'GET', undefined, false))));
846
+ .parse(await request('/api/knowledge/topics', 'GET', undefined, false)), view(text.topicsSchema, text.topicTree)));
757
847
  onboarding
758
848
  .command('deck')
759
849
  .description('Start a new draft from topic choices and get up to 8 numbered talks to judge; no account needed')
760
850
  .option('--interest <topic=level>', 'set a topic to interested or not_interested; repeatable', collect, [])
761
851
  .option('--query-text <text>', 'what the user is working on now; saved with the draft on finish')
762
- .action(run(onboardingDeck));
852
+ .action(run(onboardingDeck, view(text.deckSchema, value => text.deck(context, value))));
763
853
  onboarding
764
854
  .command('react')
765
855
  .description('Judge deck cards by number and get the recommendations they lead to; no account needed')
766
856
  .argument('<answers...>', 'card=like|dislike|skip, e.g. 1=like 3=dislike')
767
- .action(run(onboardingReact));
857
+ .action(run(onboardingReact, view(text.previewSchema, value => text.preview(context, value))));
768
858
  onboarding
769
859
  .command('finish')
770
860
  .description('Save the draft to the signed-in account')
771
861
  .option('--query-text <text>', 'replace the query text kept in the draft')
772
- .action(run(onboardingFinish));
862
+ .action(run(onboardingFinish, () => `Saved to your account. Recommendations: ${cmd()} feed`));
773
863
  program
774
864
  .command('feed')
775
865
  .description('Get personalized recommendations')
776
- .action(run(() => request('/api/knowledge/feed')));
866
+ .action(run(() => request('/api/knowledge/feed'), view(text.listSchema, value => text.talkList(context, value, `No recommendations yet. Build a profile with: ${cmd()} onboarding topics`))));
777
867
  program
778
868
  .command('request')
779
869
  .description('Make an authenticated GET request to a Knowledge API path, e.g. /api/knowledge/profile')
@@ -790,7 +880,7 @@ skill
790
880
  .command('update')
791
881
  .description('Replace installed copies of the skill that are older than this CLI; a custom description is kept')
792
882
  .option('--force', 'also replace copies that were edited by hand')
793
- .action(run((options) => updateSkills(Boolean(options.force))));
883
+ .action(run((options) => updateSkills(Boolean(options.force)), view(text.skillUpdateSchema, value => text.skillUpdate(context, value))));
794
884
  const profileTopics = z.object({
795
885
  interests: z.array(z.object({ topic: z.string().optional(), level: z.enum(['high', 'interested', 'not_interested']) })),
796
886
  topics: z.array(z.object({ slug: z.string(), title: z.string(), section: z.string().nullable() })),
@@ -844,7 +934,7 @@ async function personalizeSkill(o) {
844
934
  path: file,
845
935
  topics,
846
936
  reason: e instanceof Error ? e.message : 'Write failed',
847
- command: `${launcher} skill personalize --file ${shellQuote(file)}`,
937
+ command: `${cmd()} skill personalize --file ${shellQuote(file)}`,
848
938
  };
849
939
  }
850
940
  return { personalized: true, changed: true, path: file, topics };
@@ -853,7 +943,7 @@ skill
853
943
  .command('personalize')
854
944
  .description("Add the user's topics (ten words at most) to the description of the skill copy at --file; requires login")
855
945
  .requiredOption('--file <path>', 'SKILL.md of the loaded skill, or its folder')
856
- .action(run(personalizeSkill));
946
+ .action(run(personalizeSkill, view(text.personalizeSchema, text.personalize)));
857
947
  // The daily check runs after the command, so it never delays or breaks its output; doctor and skill report the same state themselves
858
948
  let skipNotice = false;
859
949
  program.hook('preAction', (_, action) => {
package/dist/render.js ADDED
@@ -0,0 +1,289 @@
1
+ // Text a person reads in a terminal. With --json the CLI prints the service's JSON instead; that output is the agents' contract
2
+ import { z } from 'zod';
3
+ // Server text reaches a terminal: remove control characters so a response cannot inject ANSI or OSC escape sequences
4
+ // oxlint-disable-next-line no-control-regex -- matching control characters is the purpose of this function
5
+ export const printable = (value) => value.replace(/[\u0000-\u001f\u007f-\u009f]/g, '');
6
+ /** Like printable, but keeps line breaks: talk summaries are Markdown paragraphs and lists */
7
+ const clean = (value) => value
8
+ .split(/\r?\n/)
9
+ .map(line => printable(line).replace(/\*\*(.+?)\*\*/g, (_, inner) => bold(inner)))
10
+ .join('\n');
11
+ const color = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR && process.env.TERM !== 'dumb';
12
+ const style = (code) => (text) => (color ? `\u001b[${code}m${text}\u001b[0m` : text);
13
+ export const bold = style('1');
14
+ export const dim = style('2');
15
+ /** 75 s → 1:15, 3725 s → 1:02:05 */
16
+ export function clock(ms) {
17
+ const total = Math.max(0, Math.floor(ms / 1000));
18
+ const [h, m, s] = [Math.floor(total / 3600), Math.floor((total % 3600) / 60), total % 60];
19
+ const two = (n) => String(n).padStart(2, '0');
20
+ return h ? `${h}:${two(m)}:${two(s)}` : `${m}:${two(s)}`;
21
+ }
22
+ const minutes = (ms) => `${Math.max(1, Math.round(ms / 60_000))} min`;
23
+ const days = (seconds) => {
24
+ const n = Math.round(seconds / 86_400);
25
+ return n >= 1 ? `${n} day${n === 1 ? '' : 's'}` : `${Math.max(1, Math.round(seconds / 3600))} h`;
26
+ };
27
+ const speaker = z.object({ name: z.string(), organization: z.string().nullish(), jobTitle: z.string().nullish() });
28
+ export const talkSchema = z.object({
29
+ slug: z.string(),
30
+ title: z.string(),
31
+ description: z.string().nullish(),
32
+ speakers: z.array(speaker).default([]),
33
+ topics: z.array(z.object({ title: z.string() })).default([]),
34
+ event: z.object({ name: z.string() }).nullish(),
35
+ durationMs: z.number().nullish(),
36
+ publication: z.object({ url: z.string().nullish() }).nullish(),
37
+ reason: z.string().nullish(),
38
+ bookmarked: z.boolean().nullish(),
39
+ });
40
+ const talkUrl = (context, slug) => `${context.base}/talks/${encodeURIComponent(slug)}`;
41
+ const people = (talk) => talk.speakers.map(s => (s.organization ? `${s.name} (${s.organization})` : s.name)).join(', ');
42
+ const meta = (talk) => [people(talk), talk.event?.name, talk.durationMs ? minutes(talk.durationMs) : null].filter(Boolean).join(' · ');
43
+ /** The first paragraph of the summary is its TL;DR sentence */
44
+ const tldr = (talk) => talk.description?.split(/\n\s*\n/)[0]?.trim() ?? '';
45
+ function card(context, talk, n) {
46
+ const lines = [`${dim(`${n}.`)} ${bold(printable(talk.title))}${talk.bookmarked ? dim(' ★ saved') : ''}`];
47
+ const details = meta(talk);
48
+ if (details)
49
+ lines.push(` ${dim(printable(details))}`);
50
+ if (tldr(talk))
51
+ lines.push(` ${printable(tldr(talk))}`);
52
+ if (talk.reason)
53
+ lines.push(` ${dim('Why:')} ${printable(talk.reason)}`);
54
+ lines.push(` ${dim(talkUrl(context, talk.slug))}`);
55
+ return lines.join('\n');
56
+ }
57
+ const cards = (context, items) => items.map((talk, i) => card(context, talk, i + 1)).join('\n\n');
58
+ const recId = z.uuid().optional();
59
+ /** A list with a recId attributes what the user opens or saves from it to that list */
60
+ const opened = (context, id) => id ? [`open one: ${context.launcher} talks content <slug> --rec-id ${id}`, `save one: ${context.launcher} favorites add <slug> --rec-id ${id}`] : [];
61
+ export const pageSchema = z.object({ items: z.array(talkSchema), page: z.number(), totalPages: z.number(), total: z.number().optional(), recId });
62
+ /** A page of talks with a hint for the next one; `next` builds the command for a page number */
63
+ export function talkPage(context, value, next, empty) {
64
+ if (!value.items.length)
65
+ return empty;
66
+ const footer = [`Page ${value.page} of ${value.totalPages}${value.total === undefined ? '' : ` · ${value.total} talks`}`];
67
+ if (value.page < value.totalPages)
68
+ footer.push(`next: ${context.launcher} ${next(value.page + 1)}`);
69
+ return [cards(context, value.items), '', dim(footer.join(' · ')), ...opened(context, value.recId).map(dim)].join('\n');
70
+ }
71
+ export const listSchema = z.object({ items: z.array(talkSchema), recId });
72
+ export function talkList(context, value, empty) {
73
+ return value.items.length ? [cards(context, value.items), '', ...opened(context, value.recId).map(dim)].join('\n').trimEnd() : empty;
74
+ }
75
+ export function talkDetails(context, talk) {
76
+ const lines = [bold(printable(talk.title))];
77
+ const details = [talk.event?.name, talk.durationMs ? minutes(talk.durationMs) : null].filter(Boolean).join(' · ');
78
+ if (details)
79
+ lines.push(dim(printable(details)));
80
+ for (const s of talk.speakers)
81
+ lines.push(dim(printable([s.name, s.jobTitle, s.organization].filter(Boolean).join(', '))));
82
+ if (talk.topics.length)
83
+ lines.push(dim(`Topics: ${printable(talk.topics.map(t => t.title).join(', '))}`));
84
+ if (talk.description)
85
+ lines.push('', clean(talk.description));
86
+ lines.push('', `${dim('Page:')} ${talkUrl(context, talk.slug)}`);
87
+ if (talk.publication?.url)
88
+ lines.push(`${dim('Video:')} ${printable(talk.publication.url)}`);
89
+ return lines.join('\n');
90
+ }
91
+ const chapter = z.object({ title: z.string(), startMs: z.number() });
92
+ const contentBase = z.object({ title: z.string(), speakers: z.array(speaker).default([]), chapters: z.array(chapter).default([]) });
93
+ export const contentSchema = contentBase.extend({ transcript: z.array(z.object({ startMs: z.number(), text: z.string() })) });
94
+ export const outlineSchema = contentBase.extend({ transcriptSegments: z.number() });
95
+ /** Transcript lines with a heading where each chapter starts; an outline lists the chapters only */
96
+ export function transcript(value) {
97
+ const lines = [bold(printable(value.title))];
98
+ const names = value.speakers.map(s => [s.name, s.jobTitle, s.organization].filter(Boolean).join(', '));
99
+ if (names.length)
100
+ lines.push(dim(printable(names.join('; '))));
101
+ if (!('transcript' in value)) {
102
+ lines.push('', ...value.chapters.map(c => `${dim(clock(c.startMs).padStart(8))} ${printable(c.title)}`));
103
+ lines.push('', dim(`${value.transcriptSegments} transcript segments`));
104
+ return lines.join('\n');
105
+ }
106
+ const chapters = [...value.chapters].sort((a, b) => a.startMs - b.startMs);
107
+ let next = 0;
108
+ for (const segment of value.transcript) {
109
+ let heading;
110
+ while (next < chapters.length && (chapters[next]?.startMs ?? Infinity) <= segment.startMs)
111
+ heading = chapters[next++];
112
+ if (heading)
113
+ lines.push('', bold(`## ${printable(heading.title)}`));
114
+ lines.push(`${dim(`[${clock(segment.startMs)}]`)} ${printable(segment.text)}`);
115
+ }
116
+ if (!value.transcript.length)
117
+ lines.push('', 'No transcript segments in this range.');
118
+ return lines.join('\n');
119
+ }
120
+ export const passagesSchema = z.object({
121
+ recId,
122
+ items: z.array(z.object({
123
+ talk: talkSchema,
124
+ passages: z.array(z.object({ startMs: z.number(), chapter: z.string().nullish(), text: z.string(), url: z.string() })),
125
+ })),
126
+ });
127
+ export function passages(context, value) {
128
+ if (!value.items.length)
129
+ return 'Nothing found. Try other wording or another language.';
130
+ return value.items
131
+ .map((item, i) => {
132
+ const lines = [`${dim(`${i + 1}.`)} ${bold(printable(item.talk.title))}`];
133
+ if (meta(item.talk))
134
+ lines.push(` ${dim(printable(meta(item.talk)))}`);
135
+ for (const passage of item.passages) {
136
+ lines.push('', ` ${dim(`[${clock(passage.startMs)}]${passage.chapter ? ` ${printable(passage.chapter)}` : ''}`)}`);
137
+ lines.push(` ${printable(passage.text)}`);
138
+ lines.push(` ${dim(printable(passage.url))}`);
139
+ }
140
+ return lines.join('\n');
141
+ })
142
+ .concat(value.recId ? [opened(context, value.recId).map(dim).join('\n')] : [])
143
+ .join('\n\n');
144
+ }
145
+ const topicSchema = z.object({ slug: z.string(), title: z.string(), section: z.string().nullable() });
146
+ export const topicsSchema = z.object({ topics: z.array(topicSchema) });
147
+ /** Sections first, each followed by its subtopics */
148
+ export function topicTree(value) {
149
+ const sections = value.topics.filter(t => !t.section);
150
+ const orphans = value.topics.filter(t => t.section && !sections.some(s => s.slug === t.section));
151
+ const row = (t, indent) => `${indent}${printable(t.title)} ${dim(printable(t.slug))}`;
152
+ const lines = [];
153
+ for (const section of sections) {
154
+ lines.push(bold(row(section, '')));
155
+ for (const topic of value.topics.filter(t => t.section === section.slug))
156
+ lines.push(row(topic, ' '));
157
+ lines.push('');
158
+ }
159
+ lines.push(...orphans.map(t => row(t, '')));
160
+ return lines.join('\n').trimEnd();
161
+ }
162
+ export const profileSchema = z.object({
163
+ interests: z.array(z.object({ topic: z.string().optional(), level: z.enum(['high', 'interested', 'not_interested']) })),
164
+ queryText: z.string(),
165
+ topics: z.array(topicSchema).default([]),
166
+ });
167
+ const levelNames = { high: 'Very interested', interested: 'Interested', not_interested: 'Not interested' };
168
+ export function profile(value) {
169
+ const titles = new Map(value.topics.map(t => [t.slug, t.title]));
170
+ const lines = [`${bold('Current task:')} ${value.queryText.trim() ? printable(value.queryText) : dim('not set')}`];
171
+ for (const level of ['high', 'interested', 'not_interested']) {
172
+ const topics = value.interests.flatMap(i => (i.level === level && i.topic ? [printable(titles.get(i.topic) ?? i.topic)] : []));
173
+ if (topics.length)
174
+ lines.push('', bold(`${levelNames[level]}:`), ...topics.map(t => ` ${t}`));
175
+ }
176
+ if (!value.interests.length)
177
+ lines.push('', dim('No interests yet. Set them with: profile update --interest <topic>=interested'));
178
+ return lines.join('\n');
179
+ }
180
+ export const doctorSchema = z.object({
181
+ base: z.string(),
182
+ reachable: z.boolean(),
183
+ authenticated: z.boolean(),
184
+ configPath: z.string(),
185
+ update: z.object({ installed: z.boolean(), current: z.string(), latest: z.string().nullable(), available: z.boolean(), command: z.string() }),
186
+ skills: z.array(z.object({ path: z.string(), status: z.string(), version: z.string().nullable() })),
187
+ nextStep: z.string().nullable(),
188
+ });
189
+ export function doctor(context, value) {
190
+ // ok, a problem, or plain information
191
+ const row = (state, label, detail) => `${state === null ? ' ' : state ? 'ok' : '!!'} ${label.padEnd(8)}${detail}`;
192
+ const cli = value.update.available ? `${value.update.current}; ${value.update.latest} is available: ${value.update.command}` : value.update.current;
193
+ const lines = [
194
+ row(value.reachable, 'Service', `${value.base}${value.reachable ? '' : ' is unreachable'}`),
195
+ row(value.authenticated, 'Account', value.authenticated ? 'signed in' : 'not signed in'),
196
+ row(null, 'Session', value.configPath),
197
+ row(!value.update.available, 'CLI', cli),
198
+ ];
199
+ if (!value.skills.length)
200
+ lines.push(row(null, 'Skill', 'not installed in any agent'));
201
+ for (const skill of value.skills)
202
+ lines.push(row(skill.status !== 'outdated', 'Skill', `${skill.path}: ${skill.status}`));
203
+ // The JSON names the installed command; a person gets the one that ran the CLI
204
+ if (value.nextStep)
205
+ lines.push('', `Next: ${value.reachable && !value.authenticated ? `run ${context.launcher} login` : value.nextStep}`);
206
+ return lines.join('\n');
207
+ }
208
+ export const loginPromptSchema = z.object({ verificationUrl: z.string(), userCode: z.string(), expiresIn: z.number() });
209
+ export function loginPrompt(context, value) {
210
+ return [
211
+ `Open ${value.verificationUrl}`,
212
+ `and confirm the code ${bold(value.userCode)} within ${Math.ceil(value.expiresIn / 60)} min.`,
213
+ `Then run: ${context.launcher} login --wait`,
214
+ ].join('\n');
215
+ }
216
+ export const signedInSchema = z.object({ signedIn: z.literal(true), expiresIn: z.number().optional() });
217
+ export function signedIn(value) {
218
+ return `Signed in.${value.expiresIn ? ` The session lasts ${days(value.expiresIn)}.` : ''}`;
219
+ }
220
+ export const accountSchema = z.object({ email: z.string() });
221
+ export const account = (value) => `Signed in as ${bold(printable(value.email))}`;
222
+ // Onboarding cards are already shortened by the CLI: names and titles as strings, the summary's first paragraph
223
+ const briefSchema = z.object({
224
+ slug: z.string(),
225
+ title: z.string(),
226
+ summary: z.string().nullable(),
227
+ speakers: z.array(z.string()),
228
+ event: z.string().nullable(),
229
+ reason: z.string().optional(),
230
+ });
231
+ const fromBrief = (t) => ({
232
+ slug: t.slug,
233
+ title: t.title,
234
+ description: t.summary,
235
+ speakers: t.speakers.map(name => ({ name })),
236
+ topics: [],
237
+ event: t.event ? { name: t.event } : null,
238
+ reason: t.reason,
239
+ });
240
+ export const deckSchema = z.object({ deck: z.array(briefSchema.extend({ n: z.number() })) });
241
+ export function deck(context, value) {
242
+ if (!value.deck.length)
243
+ return 'No talks for these topics. Try other topics.';
244
+ return `${value.deck.map(t => card(context, fromBrief(t), t.n)).join('\n\n')}\n\n${dim(`Judge the talks by number: ${context.launcher} onboarding react 1=like 2=dislike`)}`;
245
+ }
246
+ export const previewSchema = z.object({
247
+ preview: z.array(briefSchema),
248
+ answered: z.array(z.object({ n: z.number(), reaction: z.string().optional() })),
249
+ unanswered: z.array(z.number()),
250
+ });
251
+ export function preview(context, value) {
252
+ const lines = [
253
+ bold('Recommendations for these answers:'),
254
+ '',
255
+ value.preview.length ? cards(context, value.preview.map(fromBrief)) : 'None yet: like a few more talks.',
256
+ '',
257
+ ];
258
+ if (value.unanswered.length)
259
+ lines.push(dim(`Not judged yet: ${value.unanswered.join(', ')}`));
260
+ lines.push(dim(`Save to the account: ${context.launcher} onboarding finish`));
261
+ return lines.join('\n');
262
+ }
263
+ export const skillUpdateSchema = z.object({
264
+ version: z.string(),
265
+ updated: z.array(z.object({ path: z.string(), from: z.string().nullable() })),
266
+ unchanged: z.array(z.object({ path: z.string(), status: z.string() })),
267
+ });
268
+ export function skillUpdate(context, value) {
269
+ const lines = value.updated.map(s => `Updated ${s.path}${s.from ? ` from ${s.from}` : ''} to ${value.version}`);
270
+ for (const s of value.unchanged)
271
+ lines.push(s.status === 'modified'
272
+ ? `Kept ${s.path}: edited by hand; replace it with ${context.launcher} skill update --force`
273
+ : `Kept ${s.path}: ${s.status === 'linked' ? 'linked to this CLI' : 'already current'}`);
274
+ return lines.length ? lines.join('\n') : 'No installed copies of the skill found.';
275
+ }
276
+ export const personalizeSchema = z.object({
277
+ personalized: z.boolean(),
278
+ changed: z.boolean().optional(),
279
+ path: z.string(),
280
+ topics: z.array(z.string()),
281
+ reason: z.string().optional(),
282
+ command: z.string().optional(),
283
+ });
284
+ export function personalize(value) {
285
+ if (!value.personalized)
286
+ return `Could not write ${value.path}: ${printable(value.reason ?? '')}\nRun in your terminal: ${value.command ?? ''}`;
287
+ const topics = value.topics.length ? value.topics.map(printable).join(', ') : 'no topics yet';
288
+ return value.changed ? `Added your topics to ${value.path}: ${topics}` : `${value.path} already lists your topics: ${topics}`;
289
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@giftsofprometheus/cli",
3
- "version": "0.7.3",
3
+ "version": "0.8.1",
4
4
  "description": "World AI knowledge in Russian for you and your AI agent: search AI engineering talks, read transcripts and find production best practices from the shell, Claude Code, Codex or Cursor",
5
5
  "keywords": [
6
6
  "agent-skills",
@@ -14,6 +14,8 @@ Run `command -v giftsofprometheus`. If it is missing, run every command below as
14
14
 
15
15
  Use only the CLI. Do not call the site's API with `curl`, `fetch` or a script, even for public data: the service refuses any client other than the site and the CLI with `cli_required`, and its rules on `recId`, sign-in and feedback live in the CLI and this skill. For a path that no command covers, use `request` (see Read).
16
16
 
17
+ Pass `--json` to every command, as in the examples below: without it the CLI prints text for a person, not JSON.
18
+
17
19
  Then run `giftsofprometheus --json doctor`:
18
20
 
19
21
  - `reachable: false`: the service is unavailable; report it and stop.
@@ -83,5 +83,15 @@
83
83
  "version": "0.7.3",
84
84
  "hash": "0cfc2507e6015d09",
85
85
  "description": "description: Find AI engineering talks from conferences around the world with Russian summaries, read their full transcripts, and manage the signed-in user's favorites, interests and personal feed through the giftsofprometheus CLI, and build a starting profile in the chat. Use when the user asks for talks, speakers or transcripts on an AI engineering topic, or wants to save, list or remove favorites on Gifts of Prometheus."
86
+ },
87
+ {
88
+ "version": "0.8.0",
89
+ "hash": "205118d2b9a4eb48",
90
+ "description": "description: Find AI engineering talks from conferences around the world with Russian summaries, read their full transcripts, and manage the signed-in user's favorites, interests and personal feed through the giftsofprometheus CLI, and build a starting profile in the chat. Use when the user asks for talks, speakers or transcripts on an AI engineering topic, or wants to save, list or remove favorites on Gifts of Prometheus."
91
+ },
92
+ {
93
+ "version": "0.8.1",
94
+ "hash": "205118d2b9a4eb48",
95
+ "description": "description: Find AI engineering talks from conferences around the world with Russian summaries, read their full transcripts, and manage the signed-in user's favorites, interests and personal feed through the giftsofprometheus CLI, and build a starting profile in the chat. Use when the user asks for talks, speakers or transcripts on an AI engineering topic, or wants to save, list or remove favorites on Gifts of Prometheus."
86
96
  }
87
97
  ]