@promptbook/cli 0.114.0-2 → 0.114.0-4

package/src/book-2.0/book-language-documentation/czechBookLanguageManualDictionary.ts

@@ -47,7 +47,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 2. **Vrstva chování**:
                 \`RULE\`, \`KNOWLEDGE\`, \`WRITING SAMPLE\`, \`WRITING RULES\`, \`LANGUAGE\`, \`GOAL\` a příbuzné commitmenty.
                 3. **Vrstva schopností**:
-                \`USE*\`, \`MEMORY\` a další nástrojové commitmenty, které agentovi otevírají běhové schopnosti.
+                \`USE*\` a další nástrojové commitmenty, které agentovi otevírají běhové schopnosti.
                 4. **Vrstva skládání**:
                 Dědičnost přes \`FROM\`, znovupoužití přes \`IMPORT\` a delegování přes \`TEAM\`.
             `),
@@ -69,9 +69,9 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 4. **Skládání místo jednoho velkého agenta**:
                 Na specializované odpovědnosti použijte \`TEAM\` nebo \`IMPORT\`.
                 Kompromis: režie s koordinací, výrazně lepší modularita a znovupoužitelnost.
-                5. **Řízená paměť**:
-                Pokud používáte \`MEMORY\`, popište, co se pamatovat má a co v žádném případě ne.
-                Kompromis: přísnější návrh pravidel, lepší soukromí i kvalita zapamatovaného.
+                5. **Řízená práce s daty**:
+                Pokud používáte \`USE PRIVACY\`, popište, co smí a co v žádném případě nesmí opustit konverzaci.
+                Kompromis: přísnější návrh pravidel, lepší soukromí i kvalita odpovědí.
             `),
         },
         primitives: {
@@ -102,7 +102,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 3. **Přidejte oporu ve znalostech**
                 Přidejte commitmenty \`KNOWLEDGE\` (přímý text, nebo lokální či importovatelné zdroje).
                 4. **Přidejte schopnosti**
-                Přidejte jen ty commitmenty \`USE*\` a \`MEMORY\`, které agent opravdu potřebuje.
+                Přidejte jen ty commitmenty \`USE*\`, které agent opravdu potřebuje.
                 5. **Doplňte profilová metadata**
                 Přidejte \`META DESCRIPTION\`, \`META AVATAR\` / \`META VISUAL\` nebo \`META IMAGE\`, \`META INPUT PLACEHOLDER\`, \`META THINKING MESSAGE\` a případná upozornění.
                 6. **Připravte první interakci**
@@ -155,7 +155,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
         capabilities: {
             title: 'Commitmenty USE',
             body: spaceTrim(`
-                Commitmenty \`USE*\` zapínají schopnosti (vyhledávání, prohlížeč, napojení na projekt, e-mail, generování obrázků a další).
+                Commitmenty \`USE*\` zapínají schopnosti (napojení na projekt, kalendář, generování obrázků a další).
                 Zpřístupňují běhové nástroje a doplňují pokyny do systémové zprávy.
             `),
         },
@@ -209,16 +209,6 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 '`CLOSED` brání tomu, aby se agent upravoval během konverzace.',
             ],
         },
-        'tool-using-browser-search-agent': {
-            title: 'Agent s nástroji (prohlížeč a vyhledávač)',
-            goal: 'Umožnit rešerši na internetu s jasnou prací se zdroji.',
-            walkthrough: [
-                '`USE SEARCH ENGINE` zpřístupní vyhledávání na webu a volitelné pokyny k němu.',
-                '`USE BROWSER` zapne stahování adres a interaktivní procházení webu.',
-                'Commitmenty `RULE` dělají požadavky na spolehlivost výslovnými a opakovatelnými.',
-                'Tento vzor se hodí pro agenty na aktuální dění a ověřování faktů.',
-            ],
-        },
         'rule-and-knowledge-agent': {
             title: 'Agent s RULE a KNOWLEDGE',
             goal: 'Opřít odpovědi o výslovná omezení a připravené zdroje.',
@@ -229,16 +219,6 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 'Tento vzor použijte pro compliance, podporu a interní postupy.',
             ],
         },
-        'memory-agent-with-long-term-memory': {
-            title: 'Agent s dlouhodobou pamětí (MEMORY)',
-            goal: 'Uchovat preference uživatele napříč konverzacemi.',
-            walkthrough: [
-                '`MEMORY` přidá běhové nástroje paměti a příslušné pokyny do systémové zprávy.',
-                'Commitmenty `RULE` zúží, co se smí pamatovat, a snižují tak rizika pro soukromí.',
-                'V Agents Serveru je paměť vedená za běhu a je vázaná na konkrétního uživatele.',
-                'Hodí se pro asistenty, kteří si musí držet kontext v čase.',
-            ],
-        },
         'use-project-integration-agent': {
             title: 'Napojení na projekt (USE PROJECT)',
             goal: 'Pracovat s repozitářem na GitHubu přes připojení projektu.',
@@ -283,7 +263,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
         {
             title: 'Neověřitelná tvrzení',
             dont: 'Agent odpovídá na otázky závislé na internetu bez nástrojů nebo bez uvedení zdrojů.',
-            doInstead: 'Přidejte `USE SEARCH ENGINE` / `USE BROWSER` a `RULE` zaměřené na citování.',
+            doInstead: 'Přidejte zdroje `KNOWLEDGE` a `RULE` zaměřené na citování.',
         },
         {
             title: 'Chybějící mantinely',
@@ -295,11 +275,6 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
             dont: 'Dlouhé řetězce `FROM` bez vysvětlení, proč je každý rodič potřeba.',
             doInstead: 'Držte dědičnost mělkou a pro znovupoužití sáhněte po cíleném IMPORT nebo TEAM.',
         },
-        {
-            title: 'Nebezpečné zacházení s pamětí',
-            dont: 'Ukládání každého detailu do paměti bez jakýchkoli hranic.',
-            doInstead: 'Doplňte `MEMORY` výslovnými pravidly, co se smí uchovávat.',
-        },
     ],
     tutorialSections: {
         serverAgentsHint:

package/src/book-2.0/book-language-documentation/englishBookLanguageManualDictionary.ts

@@ -47,7 +47,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 2. **Behavior layer**:
                 \`RULE\`, \`KNOWLEDGE\`, \`WRITING SAMPLE\`, \`WRITING RULES\`, \`LANGUAGE\`, \`GOAL\`, and related commitments.
                 3. **Capability layer**:
-                \`USE*\`, \`MEMORY\`, and other tooling commitments exposing runtime abilities.
+                \`USE*\` and other tooling commitments exposing runtime abilities.
                 4. **Composition layer**:
                 \`FROM\` inheritance, \`IMPORT\` reuse, and \`TEAM\` delegation.
             `),
@@ -69,8 +69,8 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 4. **Composition over monoliths**:
                 Use \`TEAM\`/\`IMPORT\` for specialized responsibilities.
                 Tradeoff: orchestration overhead, stronger modularity and reuse.
-                5. **Controlled memory**:
-                If using \`MEMORY\`, define what must and must not be remembered.
+                5. **Controlled data access**:
+                If using \`USE PRIVACY\`, define what must and must not leave the conversation.
                 Tradeoff: stricter policy design, better privacy and signal quality.
             `),
         },
@@ -102,7 +102,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 3. **Add grounding**
                 Add \`KNOWLEDGE\` commitments (inline text or local/importable sources).
                 4. **Add capabilities**
-                Add only necessary \`USE*\` and/or \`MEMORY\` commitments.
+                Add only necessary \`USE*\` commitments.
                 5. **Set profile metadata**
                 Add \`META DESCRIPTION\`, \`META AVATAR\` / \`META VISUAL\` or \`META IMAGE\`, \`META INPUT PLACEHOLDER\`, \`META THINKING MESSAGE\`, and disclaimers if needed.
                 6. **Add first interaction**
@@ -155,7 +155,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
         capabilities: {
             title: 'USE commitments',
             body: spaceTrim(`
-                \`USE*\` commitments enable capabilities (search, browser, project integration, email, image generation, etc.).
+                \`USE*\` commitments enable capabilities (project integration, calendar, image generation, etc.).
                 They expose runtime tools and system-message guidance used during execution.
             `),
         },
@@ -209,16 +209,6 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 '`CLOSED` prevents conversational self-modification.',
             ],
         },
-        'tool-using-browser-search-agent': {
-            title: 'Tool-using agent (Browser + Search engine)',
-            goal: 'Enable internet research with clear sourcing behavior.',
-            walkthrough: [
-                '`USE SEARCH ENGINE` provides web search tooling and optional search instructions.',
-                '`USE BROWSER` enables URL fetching and interactive browsing tools.',
-                '`RULE` commitments make reliability behavior explicit and repeatable.',
-                'This pattern is ideal for current-events and fact-checking agents.',
-            ],
-        },
         'rule-and-knowledge-agent': {
             title: 'Agent with RULE and KNOWLEDGE',
             goal: 'Ground responses in explicit constraints and curated sources.',
@@ -229,16 +219,6 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 'Use this pattern for compliance, support, and internal procedures.',
             ],
         },
-        'memory-agent-with-long-term-memory': {
-            title: 'MEMORY agent with long-term memory',
-            goal: 'Persist user preferences across conversations.',
-            walkthrough: [
-                '`MEMORY` adds runtime memory tools and memory-specific system guidance.',
-                '`RULE` commitments narrow what should be remembered to reduce privacy risks.',
-                'In Agents Server, memory is runtime-backed and user-scoped.',
-                'Use this for assistants that must preserve context over time.',
-            ],
-        },
         'use-project-integration-agent': {
             title: 'USE PROJECT external integration',
             goal: 'Work with a GitHub repository through a connected project integration.',
@@ -283,7 +263,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
         {
             title: 'Unverifiable claims',
             dont: 'The agent answers internet-dependent questions without tools or without citing sources.',
-            doInstead: 'Add `USE SEARCH ENGINE` / `USE BROWSER` and a citation-oriented `RULE`.',
+            doInstead: 'Add `KNOWLEDGE` sources and a citation-oriented `RULE`.',
         },
         {
             title: 'Missing guardrails',
@@ -295,11 +275,6 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
             dont: 'Using deep `FROM` chains without documenting why each parent is needed.',
             doInstead: 'Keep inheritance shallow and use focused IMPORT/TEAM composition for reuse.',
         },
-        {
-            title: 'Unsafe memory usage',
-            dont: 'Storing every detail in memory without boundaries.',
-            doInstead: 'Pair `MEMORY` with explicit rules about what is allowed to persist.',
-        },
     ],
     tutorialSections: {
         serverAgentsHint:

package/src/book-3.0/LiteAgent.ts

@@ -1,10 +1,4 @@
-import {
-    Agent as AgentFromKit,
-    fileSearchTool,
-    run,
-    setDefaultOpenAIClient,
-    setDefaultOpenAIKey,
-} from '@openai/agents';
+import type { Agent as AgentFromKit } from '@openai/agents';
 import { readFile } from 'fs/promises';
 import { basename, resolve } from 'path';
 import { fileURLToPath } from 'url';
@@ -17,6 +11,7 @@ import { computeOpenAiUsage } from '../llm-providers/openai/computeOpenAiUsage';
 import { OPENAI_MODELS } from '../llm-providers/openai/openai-models';
 import { OpenAiAgentKitExecutionToolsToolBuilder } from '../llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder';
 import { OpenAiVectorStoreHandler } from '../llm-providers/openai/OpenAiVectorStoreHandler';
+import { loadOpenAiAgentsModule } from '../llm-providers/openai/utils/loadOpenAiAgentsModule';
 import { $provideScriptingForNode } from '../scrapers/_common/register/$provideScriptingForNode';
 import type { string_knowledge_source_link } from '../types/string_knowledge_source_content';
 import type { string_markdown, string_markdown_text } from '../types/string_markdown';
@@ -112,6 +107,7 @@ export class LiteAgent {
         const preparedAgent = await this.prepareAgent();
         preparedAgent.toolBuilder?.clearRunState();
 
+        const { run } = await loadOpenAiAgentsModule();
         const result = await run(
             preparedAgent.agent,
             createLiteAgentPromptText(normalizedMessage, options.context, preparedAgent.modelRequirements.promptSuffix),
@@ -165,6 +161,12 @@ export class LiteAgent {
             userId: this.options.userId,
         });
         const client = await runtime.getClient();
+        const {
+            Agent: AgentFromKit,
+            fileSearchTool,
+            setDefaultOpenAIClient,
+            setDefaultOpenAIKey,
+        } = await loadOpenAiAgentsModule();
 
         setDefaultOpenAIClient(client as TODO_any);
 
@@ -190,9 +192,9 @@ export class LiteAgent {
                   })
                 : null;
         const agentTools =
-            toolBuilder?.buildAgentKitTools({
+            (await toolBuilder?.buildAgentKitTools({
                 tools: modelRequirements.tools ? [...modelRequirements.tools] : undefined,
-            }) || [];
+            })) || [];
         const normalizedKnowledgeSources = await normalizeLiteAgentKnowledgeSources(
             modelRequirements.knowledgeSources || [],
             resolvedSource.sourceDirectoryPath,

package/src/book-components/BookEditor/useBookEditorMonacoLanguage.ts

@@ -162,7 +162,7 @@ function createCommitmentRegex(commitmentTypes: ReadonlyArray<string>): RegExp {
 
     const commitmentPatterns = [...commitmentTypes]
         .sort((a: string, b: string) => b.length - a.length)
-        .map((type: string) => (type === 'META' ? 'META\\s+\\w+' : type.replace(/\s+/, '\\s+')))
+        .map((type: string) => type.replace(/\s+/, '\\s+'))
         .join('|');
 
     return new RegExp(`^\\s*(${commitmentPatterns})(?=\\s|$)`);

package/src/book-components/Chat/utils/$provideServerDomWindow.ts

@@ -0,0 +1,77 @@
+import type { WindowLike as DomWindowLike } from 'dompurify';
+import { spaceTrim } from 'spacetrim';
+import { assertsError } from '../../../errors/assertsError';
+import { EnvironmentMismatchError } from '../../../errors/EnvironmentMismatchError';
+
+/**
+ * Shared DOM window reused by every render which happens outside of a browser
+ *
+ * @private utility of `$provideServerDomWindow`
+ */
+let serverDomWindow: DomWindowLike | null = null;
+
+/**
+ * Provides a DOM `window` for runtimes which do not have one, for example Node.js during server-side rendering
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it creates and caches one shared DOM window
+ *
+ * @returns DOM window which can back a DOM-dependent library like `DOMPurify`
+ * @throws {EnvironmentMismatchError} When the current runtime can not create a DOM window
+ * @private utility of `renderMarkdown`
+ */
+export function $provideServerDomWindow(): DomWindowLike {
+    if (serverDomWindow === null) {
+        const { JSDOM } = requireServerDomLibrary();
+        serverDomWindow = new JSDOM('').window as unknown as DomWindowLike;
+    }
+
+    return serverDomWindow;
+}
+
+/**
+ * Loads `jsdom` which backs the DOM window outside of a browser
+ *
+ * Note: [😷] `jsdom` reaches for Node.js built-ins like `fs`, `child_process` and `net`, so browser bundlers must
+ *       never follow the `require` below - even though it is unreachable in a browser, bundlers resolve it statically.
+ *       They are told to replace `jsdom` with an empty module by the `browser` field of the generated package
+ *       manifests, which is written by `applyBrowserUnsupportedDependencyStubs` during the package generation.
+ *
+ * @returns The `jsdom` library
+ * @throws {EnvironmentMismatchError} When `jsdom` can not be loaded in the current runtime
+ * @private utility of `$provideServerDomWindow`
+ */
+function requireServerDomLibrary(): typeof import('jsdom') {
+    let serverDomLibrary: Partial<typeof import('jsdom')> | null = null;
+    let serverDomLibraryError: Error | null = null;
+
+    try {
+        // Note: [😷] Keep `'jsdom'` written as a literal, bundlers do not replace a computed module name
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        serverDomLibrary = require('jsdom') as typeof import('jsdom');
+    } catch (error) {
+        assertsError(error);
+        serverDomLibraryError = error;
+    }
+
+    if (typeof serverDomLibrary?.JSDOM !== 'function') {
+        throw new EnvironmentMismatchError(
+            spaceTrim(
+                (block) => `
+                    Markdown can not be rendered because there is no DOM in the current runtime.
+
+                    Rendered markdown is sanitized through \`DOMPurify\`, which needs a DOM - the DOM of the browser
+                    when the code runs in a browser and \`jsdom\` in every other runtime, for example during
+                    server-side rendering in **Node.js**.
+
+                    ${block(
+                        serverDomLibraryError === null
+                            ? 'The `jsdom` module was resolved but it does not export `JSDOM`, which happens when a bundler replaces `jsdom` with an empty module in a build which is neither a browser build nor a Node.js build.'
+                            : `${serverDomLibraryError.name}: ${serverDomLibraryError.message}`,
+                    )}
+                `,
+            ),
+        );
+    }
+
+    return serverDomLibrary as typeof import('jsdom');
+}

package/src/book-components/Chat/utils/renderMarkdown.ts

@@ -9,6 +9,7 @@ import type { Converter as ShowdownConverter } from 'showdown';
 import showdown from 'showdown';
 import type { string_html, string_markdown } from '../../../types/string_markdown';
 import { TODO_USE } from '../../../utils/organization/TODO_USE';
+import { $provideServerDomWindow } from './$provideServerDomWindow';
 import { createCitationMarkerRegex, parseCitationMarker } from './parseCitationMarker';
 
 /**
@@ -218,13 +219,6 @@ let browserMarkdownSanitizer: DomPurifyInstance | null = null;
  */
 let serverMarkdownSanitizer: DomPurifyInstance | null = null;
 
-/**
- * Shared JSDOM window backing the server-side DOMPurify instance.
- *
- * @private utility of `renderMarkdown`
- */
-let serverMarkdownSanitizerWindow: DomPurifyWindowLike | null = null;
-
 /**
  * Pattern matching CODE FENCE.
  */
@@ -546,21 +540,6 @@ function createMarkdownSanitizer(sanitizerWindow: DomPurifyWindowLike): DomPurif
     return markdownSanitizer;
 }
 
-/**
- * Lazily creates the JSDOM window used by server-side markdown sanitization.
- *
- * @private utility of `renderMarkdown`
- */
-function getServerMarkdownSanitizerWindow(): DomPurifyWindowLike {
-    if (!serverMarkdownSanitizerWindow) {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const { JSDOM } = require('jsdom') as typeof import('jsdom');
-        serverMarkdownSanitizerWindow = new JSDOM('').window as unknown as DomPurifyWindowLike;
-    }
-
-    return serverMarkdownSanitizerWindow;
-}
-
 /**
  * Returns the shared DOMPurify instance appropriate for the current runtime.
  *
@@ -573,7 +552,7 @@ function getMarkdownSanitizer(): DomPurifyInstance {
         return browserMarkdownSanitizer;
     }
 
-    serverMarkdownSanitizer ??= createMarkdownSanitizer(getServerMarkdownSanitizerWindow());
+    serverMarkdownSanitizer ??= createMarkdownSanitizer($provideServerDomWindow());
 
     return serverMarkdownSanitizer;
 }

package/src/cli/cli-commands/agents-server/buildAgentsServer/createAgentsServerRuntimeEnvironment.ts

@@ -22,6 +22,14 @@ export const PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT_ENV = 'PTBK_AGENTS_SERVER_BUI
  */
 export const PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV = 'PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION';
 
+/**
+ * Environment variable that disables throwaway webpack filesystem caches for CLI-owned production builds.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export const PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE_ENV =
+    'PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE';
+
 /**
  * Conservative Next.js build worker count used by CLI-owned Agents Server production builds.
  *
@@ -41,6 +49,7 @@ export function createAgentsServerRuntimeEnvironment(
     nodeModulesPath: string,
     options: {
         readonly isNextValidationIgnored?: boolean;
+        readonly isWebpackFilesystemCacheDisabled?: boolean;
     } = {},
 ): NodeJS.ProcessEnv {
     return {
@@ -54,6 +63,11 @@ export function createAgentsServerRuntimeEnvironment(
                   [PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV]: 'true',
               }
             : {}),
+        ...(options.isWebpackFilesystemCacheDisabled
+            ? {
+                  [PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE_ENV]: 'true',
+              }
+            : {}),
     };
 }
 

package/src/cli/cli-commands/agents-server/buildAgentsServer/ensureAgentsServerBuild.ts

@@ -30,6 +30,7 @@ export async function ensureAgentsServerBuild(
     });
     const buildEnvironment = createAgentsServerRuntimeEnvironment(environment, preparedRuntime.nodeModulesPath, {
         isNextValidationIgnored: preparedRuntime.isAppPathMaterialized,
+        isWebpackFilesystemCacheDisabled: true,
     });
 
     if (

package/src/cli/cli-commands/coder/add.ts

@@ -4,12 +4,18 @@ import type {
 } from 'commander';
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
-import prompts from 'prompts';
 import { spaceTrim } from 'spacetrim';
 import { NotAllowed } from '../../../errors/NotAllowed';
 import { ParseError } from '../../../errors/ParseError';
 import { normalizeToKebabCase } from '../../../utils/normalization/normalize-to-kebab-case';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
+import { loadPromptsModule } from '../../common/loadPromptsModule';
+import type { CoderGitSyncCliOptions } from '../common/coderGitSyncCliOptions';
+import {
+    addCoderGitSyncOptions,
+    CODER_GIT_SYNC_DESCRIPTION,
+    normalizeCoderGitSyncCliOptions,
+} from '../common/coderGitSyncCliOptions';
 import { handleActionErrors } from '../common/handleActionErrors';
 import {
     buildCoderPromptSection,
@@ -49,15 +55,19 @@ const FALLBACK_PROMPT_SLUG = 'prompt';
 export function $initializeCoderAddCommand(program: Program): $side_effect {
     const command = program.command('add');
     command.description(
-        spaceTrim(`
-            Add one ready-to-run prompt file to the queue
+        spaceTrim(
+            (block) => `
+                Add one ready-to-run prompt file to the queue
 
-            Provide the description as an argument, pipe it through stdin, or run without arguments to type it interactively:
-            - \`ptbk coder add "some new feature"\`
-            - \`ptbk coder add --priority 1 "some new feature"\`
-            - \`ptbk coder add <<EOF ... EOF\`
-            - \`ptbk coder add\`
-        `),
+                Provide the description as an argument, pipe it through stdin, or run without arguments to type it interactively:
+                - \`ptbk coder add "some new feature"\`
+                - \`ptbk coder add --priority 1 "some new feature"\`
+                - \`ptbk coder add <<EOF ... EOF\`
+                - \`ptbk coder add\`
+
+                ${block(CODER_GIT_SYNC_DESCRIPTION)}
+            `,
+        ),
     );
 
     command.argument('[description]', 'Plain-language description of the feature or task to implement');
@@ -77,22 +87,39 @@ export function $initializeCoderAddCommand(program: Program): $side_effect {
                 .join(', ')}) or a markdown file path relative to the current project root.
         `),
     );
+    addCoderGitSyncOptions(command);
 
     command.action(
         handleActionErrors(async (descriptionArgument: string | undefined, cliOptions) => {
             const { priority, template: templateOption } = cliOptions as {
                 readonly priority: number;
                 readonly template?: string;
-            };
+            } & CoderGitSyncCliOptions;
+
+            const gitSync = normalizeCoderGitSyncCliOptions(cliOptions as CoderGitSyncCliOptions);
+            const projectPath = process.cwd();
 
             const description = await resolveCoderPromptDescription(descriptionArgument);
 
-            await addCoderPrompt({
-                projectPath: process.cwd(),
+            // Note: Import the git synchronization dynamically to keep the CLI fast for runs without `--commit`
+            const { $commitCoderChanges, $pullCoderChanges } = await import(
+                '../../../../scripts/run-codex-prompts/git/coderGitSync'
+            );
+
+            await $pullCoderChanges({ gitSync, projectPath });
+
+            const { /* filePath,*/ emojiTag } = await addCoderPrompt({
+                projectPath,
                 description,
                 priority,
                 templateOption,
             });
+
+            await $commitCoderChanges({
+                gitSync,
+                projectPath,
+                commitMessage: `${emojiTag} Add prompt`,
+            });
         }),
     );
 }
@@ -216,6 +243,7 @@ async function resolveCoderPromptDescription(descriptionArgument: string | undef
         return standardInputDescription;
     }
 
+    const { default: prompts } = await loadPromptsModule();
     const response = await prompts({
         type: 'text',
         name: 'description',

package/src/cli/cli-commands/coder/boilerplateCount.ts

@@ -0,0 +1,139 @@
+import { spaceTrim } from 'spacetrim';
+import { NotAllowed } from '../../../errors/NotAllowed';
+
+/**
+ * Separator between the number of generated files and the number of prompts in each of them,
+ * for example `10*7`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+const BOILERPLATE_COUNT_SEPARATOR = '*';
+
+/**
+ * Pattern of the `--count` option value, either `N` or `N*M`.
+ */
+const BOILERPLATE_COUNT_PATTERN = /^(?<filesCount>\d+)(?:\s*\*\s*(?<promptsPerFileCount>\d+))?$/u;
+
+/**
+ * How many prompt boilerplate files are generated and how many prompts each of them contains.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export type BoilerplateCount = {
+    /**
+     * Number of generated prompt boilerplate files.
+     */
+    readonly filesCount: number;
+
+    /**
+     * Number of prompts written into each generated file.
+     *
+     * Note: More than one prompt per file is an advanced option - each prompt is one separate
+     *       coding task separated by `---` and tagged with its own fresh emoji tag.
+     */
+    readonly promptsPerFileCount: number;
+};
+
+/**
+ * Number of prompt boilerplate files and prompts per file used when `--count` is not provided.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export const DEFAULT_BOILERPLATE_COUNT: BoilerplateCount = {
+    filesCount: 5,
+    promptsPerFileCount: 1,
+};
+
+/**
+ * Formats one boilerplate count back into the `N*M` notation of the `--count` option.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export function formatBoilerplateCount({ filesCount, promptsPerFileCount }: BoilerplateCount): string {
+    return `${filesCount}${BOILERPLATE_COUNT_SEPARATOR}${promptsPerFileCount}`;
+}
+
+/**
+ * Default value of the `--count` option rendered in the `N*M` notation, for example `5*1`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export const DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE = formatBoilerplateCount(DEFAULT_BOILERPLATE_COUNT);
+
+/**
+ * Description of the `--count` option shared by all commands which generate prompt boilerplates.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export const BOILERPLATE_COUNT_OPTION_DESCRIPTION = spaceTrim(`
+    Number of generated prompt boilerplate files, optionally with the number of prompts in each of them.
+
+    Use \`N\` (or \`N*1\`) for N files with one prompt each,
+    or the advanced \`N*M\` notation for N files with M prompts each, for example \`10*7\`.
+`);
+
+/**
+ * Parses the `--count` option value into the number of files and the number of prompts in each of them.
+ *
+ * Both notations are supported:
+ * - `N` and `N*1` => N files with one prompt each
+ * - `N*M` => N files with M prompts each
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export function parseBoilerplateCount(countOption: string): BoilerplateCount {
+    const normalizedCountOption = countOption.trim();
+    const match = BOILERPLATE_COUNT_PATTERN.exec(normalizedCountOption);
+
+    if (match === null) {
+        throw new NotAllowed(
+            spaceTrim(`
+                Invalid value for \`--count\`: \`${countOption}\`.
+
+                Use either \`N\` for N files with one prompt each,
+                or the advanced \`N*M\` notation for N files with M prompts each:
+
+                - \`--count 5\`
+                - \`--count 5*1\`
+                - \`--count 10*7\`
+            `),
+        );
+    }
+
+    const filesCount = Number(match.groups?.filesCount);
+    const promptsPerFileCount =
+        match.groups?.promptsPerFileCount === undefined
+            ? DEFAULT_BOILERPLATE_COUNT.promptsPerFileCount
+            : Number(match.groups.promptsPerFileCount);
+
+    assertsPositiveBoilerplateCountPart(filesCount, countOption, 'number of generated files');
+    assertsPositiveBoilerplateCountPart(promptsPerFileCount, countOption, 'number of prompts in each file');
+
+    return { filesCount, promptsPerFileCount };
+}
+
+/**
+ * Asserts that one part of the `--count` option value is a positive integer.
+ *
+ * @private internal utility of `parseBoilerplateCount`
+ */
+function assertsPositiveBoilerplateCountPart(
+    countPart: number,
+    countOption: string,
+    countPartDescription: string,
+): void {
+    if (Number.isInteger(countPart) && countPart > 0) {
+        return;
+    }
+
+    throw new NotAllowed(
+        spaceTrim(`
+            Invalid value for \`--count\`: \`${countOption}\`.
+
+            The ${countPartDescription} must be **a positive integer**, for example \`--count 10*7\`.
+        `),
+    );
+}
+
+// Note: [🟡] Code for coder boilerplate count [boilerplateCount](src/cli/cli-commands/coder/boilerplateCount.ts) should never be published outside of `@promptbook/cli`
+// Note: [💞] Ignore a discrepancy between file name and exported helper names