{"_id":"@8xlabsai/hekaya-kb-cli","_rev":"2-7b73cde86f709611d7c8d411732e49a4","name":"@8xlabsai/hekaya-kb-cli","dist-tags":{"latest":"0.2.1"},"versions":{"0.2.0":{"name":"@8xlabsai/hekaya-kb-cli","version":"0.2.0","license":"MIT","_id":"@8xlabsai/hekaya-kb-cli@0.2.0","maintainers":[{"name":"batout","email":"amr.z.abdo@gmail.com"}],"homepage":"https://github.com/8xlabs-ai/hekaya.ai#readme","bugs":{"url":"https://github.com/8xlabs-ai/hekaya.ai/issues"},"bin":{"hekaya":"dist/cli.js"},"dist":{"shasum":"64bcdb88983bd13a7f8d93edfb9fce55bdc9c5ad","tarball":"https://registry.npmjs.org/@8xlabsai/hekaya-kb-cli/-/hekaya-kb-cli-0.2.0.tgz","fileCount":2,"integrity":"sha512-5TCmQrimayPfKiV9in31jWaVOygLhnPkIt4VTqfBpmxq5gnumkQ+Ge/Lqq1l0JPWgKab5WCRgKGEt4QR2KU1vQ==","signatures":[{"sig":"MEUCICG99liSEwVZxebaD4qbSR8ujb4yc199rWCN7BkmYarWAiEA3PHdBOFCxZu0KUx3CW/lK9lumKzx+X3qaOqzQB1yi0g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9462},"type":"module","_from":"file:8xlabsai-hekaya-kb-cli-0.2.0.tgz","scripts":{"dev":"tsup --watch","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"batout","email":"amr.z.abdo@gmail.com"},"_resolved":"/tmp/ee34306536bea9779b1897462434a3e8/8xlabsai-hekaya-kb-cli-0.2.0.tgz","_integrity":"sha512-5TCmQrimayPfKiV9in31jWaVOygLhnPkIt4VTqfBpmxq5gnumkQ+Ge/Lqq1l0JPWgKab5WCRgKGEt4QR2KU1vQ==","repository":{"url":"git+https://github.com/8xlabs-ai/hekaya.ai.git","type":"git","directory":"packages/kb-cli"},"_npmVersion":"10.8.2","description":"Hekaya knowledge-base ingestion CLI — scans your frontend project, extracts text, uploads to your tenant.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"ora":"^8.1.1","kleur":"^4.1.5","prompts":"^2.4.2","commander":"^12.1.0","fast-glob":"^3.3.2","@8xlabsai/hekaya-shared-types":"0.2.0","@8xlabsai/hekaya-playbook-schema":"0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","typescript":"^5.6.3","@types/node":"^22.9.0","@types/prompts":"^2.4.9","@hekaya/config-tsconfig":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/hekaya-kb-cli_0.2.0_1778374202253_0.007284862465740005","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@8xlabsai/hekaya-kb-cli","version":"0.2.1","description":"Hekaya knowledge-base ingestion CLI — scans your frontend project, extracts text, uploads to your tenant.","license":"MIT","type":"module","bin":{"hekaya":"dist/cli.js"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/8xlabs-ai/hekaya.ai.git","directory":"packages/kb-cli"},"dependencies":{"commander":"^12.1.0","fast-glob":"^3.3.2","kleur":"^4.1.5","ora":"^8.1.1","prompts":"^2.4.2","@8xlabsai/hekaya-playbook-schema":"0.2.1","@8xlabsai/hekaya-shared-types":"0.2.1"},"devDependencies":{"@types/node":"^22.9.0","@types/prompts":"^2.4.9","tsup":"^8.3.5","typescript":"^5.6.3","@hekaya/config-tsconfig":"0.0.0"},"scripts":{"build":"tsup","dev":"tsup --watch","typecheck":"tsc --noEmit"},"_id":"@8xlabsai/hekaya-kb-cli@0.2.1","bugs":{"url":"https://github.com/8xlabs-ai/hekaya.ai/issues"},"homepage":"https://github.com/8xlabs-ai/hekaya.ai#readme","_integrity":"sha512-EsrvSumFaYfGh4ZQ9G51vic2Pc3LrvG1q+p87Ch/5SGtWRLxTcQRVtmLjP9llh7wRPxelb1GFGYMC14tbvZWgw==","_resolved":"/tmp/6e7733b78b249438b67ef6cbd68dbe45/8xlabsai-hekaya-kb-cli-0.2.1.tgz","_from":"file:8xlabsai-hekaya-kb-cli-0.2.1.tgz","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-EsrvSumFaYfGh4ZQ9G51vic2Pc3LrvG1q+p87Ch/5SGtWRLxTcQRVtmLjP9llh7wRPxelb1GFGYMC14tbvZWgw==","shasum":"10125aac53948a99e5d2ba2b4100642f7cb00964","tarball":"https://registry.npmjs.org/@8xlabsai/hekaya-kb-cli/-/hekaya-kb-cli-0.2.1.tgz","fileCount":3,"unpackedSize":11979,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAh1EiCEbajDeJ5XAkq7KMHZyV87m7xN0Rhz+OHiS9fZAiEA5monqIxNm19eIxPbdj2O83GxIOc795lvL0sf4YNUo+Q="}]},"_npmUser":{"name":"batout","email":"amr.z.abdo@gmail.com"},"directories":{},"maintainers":[{"name":"batout","email":"amr.z.abdo@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hekaya-kb-cli_0.2.1_1778374818441_0.07126335638567638"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-10T00:50:02.183Z","modified":"2026-05-10T01:00:18.722Z","0.2.0":"2026-05-10T00:50:02.401Z","0.2.1":"2026-05-10T01:00:18.589Z"},"bugs":{"url":"https://github.com/8xlabs-ai/hekaya.ai/issues"},"license":"MIT","homepage":"https://github.com/8xlabs-ai/hekaya.ai#readme","repository":{"type":"git","url":"git+https://github.com/8xlabs-ai/hekaya.ai.git","directory":"packages/kb-cli"},"description":"Hekaya knowledge-base ingestion CLI — scans your frontend project, extracts text, uploads to your tenant.","maintainers":[{"name":"batout","email":"amr.z.abdo@gmail.com"}],"readme":"# @8xlabsai/hekaya-kb-cli\n\n[![npm version](https://img.shields.io/npm/v/@8xlabsai/hekaya-kb-cli.svg)](https://www.npmjs.com/package/@8xlabsai/hekaya-kb-cli)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\nCLI that seeds your [Hekaya](https://github.com/8xlabs-ai/hekaya.ai) tenant's knowledge base by scanning your frontend project. Detects React / Angular / generic codebases, extracts user-visible strings + route metadata, and uploads them to your tenant for the AI sales agent to ground answers in.\n\n## Install\n\n```bash\n# One-off via npx (recommended for v1):\nnpx @8xlabsai/hekaya-kb-cli login\n\n# Or globally:\npnpm add -g @8xlabsai/hekaya-kb-cli\nhekaya login\n```\n\n## Quickstart (founder onboarding flow)\n\n```bash\n# 1. Authenticate against your Hekaya dashboard:\nnpx @8xlabsai/hekaya-kb-cli login\n# → opens browser to mint a CLI token; pasted back automatically.\n\n# 2. Scan your frontend project:\ncd path/to/your/frontend\nnpx @8xlabsai/hekaya-kb-cli scan\n# → detects framework (Angular / React / generic), produces .hekaya/scan.json\n\n# 3. Upload to your tenant:\nnpx @8xlabsai/hekaya-kb-cli upload --tenant your-tenant-slug\n# → KB chunks created server-side + indexed for retrieval.\n```\n\n## Commands\n\n- **`hekaya login`** — opens the dashboard's CLI-token mint page; reads back the plaintext token (one-time reveal). Persists to `~/.hekaya/credentials`.\n- **`hekaya scan`** — walks the working directory, detects framework, extracts text + route metadata, writes `.hekaya/scan.json`. Respects `.gitignore`.\n- **`hekaya upload [--tenant <slug>]`** — POSTs `.hekaya/scan.json` to the orchestrator's `/api/v1/kb/upload`. Server replays the chunks under the tenant's RLS context.\n\n## Supported frameworks\n\n- **React** — JSX/TSX text nodes, file-based routes (Next.js / Remix / Vite plugins).\n- **Angular** — template `i18n` markers, component selector + route module map.\n- **Generic** — plain HTML scrape + sitemap discovery.\n\nAuto-detected via `.hekaya scan` based on files in the project root.\n\n## Privacy\n\nThe CLI uploads only user-visible strings — never source code, never tokens, never `.env` values. Excludes `node_modules`, `dist`, `build`, and any path matched by `.gitignore`. Files containing the literal word `secret` or `token` in the basename are skipped as a belt-and-suspenders measure.\n\n## Source\n\nMonorepo: [github.com/8xlabs-ai/hekaya.ai](https://github.com/8xlabs-ai/hekaya.ai) → `packages/kb-cli/`.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}