## DEV

npx openapi-typescript http://localhost:4000/api-yaml -o ./src/lib/api.def.ts

PROD

npx openapi-typescript https://api.capibox.com/api-yaml -o ./src/lib/api.def.ts

AI docs generate prompt

at docs/browser/session/create.md create sample calls for browser.session.create function

Include samples with all required params and then with all optional params (if exists)

Include short description for each sample.

Include response examples.

ClickUp: Upload Markdown to Doc/Page

A helper script is included to upload a local Markdown file to a ClickUp Doc (or a page within a Doc).

Requirements:

• Node.js 18+ (for built-in fetch). If using older Node, install either node-fetch or undici in your environment.
• A ClickUp API token with permission to modify the target Doc/Page.

Environment variables and CLI options:

• You can put these in a .env file at the project root; the script auto-loads it.
• CLICKUP_TOKEN or --token
• CLICKUP_DOC_ID or --docId
• Optional CLICKUP_PAGE_ID or --pageId
• Optional CLICKUP_API_BASE or --endpoint (defaults to https://api.clickup.com/api/v2)
• Optional --title (if omitted, the script uses the first H1 in the Markdown or filename)
• Optional --dryRun (prints payload without calling the API)

Usage examples:

• npx: npm run clickup:upload-md -- --file docs/browser/session/create.md --docId <DOC_ID>
• With env vars: CLICKUP_TOKEN=xxx CLICKUP_DOC_ID=yyy npm run clickup:upload-md -- --file ./README.md
• With page: npm run clickup:upload-md -- --file ./README.md --docId <DOC_ID> --pageId <PAGE_ID> --title "My Page"

Notes:

• The script converts Markdown to basic HTML before uploading as content. If your workspace expects a different payload shape for Docs, adjust the script accordingly.