npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@8xlabsai/hekaya-kb-cli

v0.2.1

Published

Hekaya knowledge-base ingestion CLI — scans your frontend project, extracts text, uploads to your tenant.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

batoutbatout

Keywords

Readme

@8xlabsai/hekaya-kb-cli

npm version License: MIT

CLI that seeds your Hekaya 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.

Install

# One-off via npx (recommended for v1):
npx @8xlabsai/hekaya-kb-cli login

# Or globally:
pnpm add -g @8xlabsai/hekaya-kb-cli
hekaya login

Quickstart (founder onboarding flow)

# 1. Authenticate against your Hekaya dashboard:
npx @8xlabsai/hekaya-kb-cli login
# → opens browser to mint a CLI token; pasted back automatically.

# 2. Scan your frontend project:
cd path/to/your/frontend
npx @8xlabsai/hekaya-kb-cli scan
# → detects framework (Angular / React / generic), produces .hekaya/scan.json

# 3. Upload to your tenant:
npx @8xlabsai/hekaya-kb-cli upload --tenant your-tenant-slug
# → KB chunks created server-side + indexed for retrieval.

Commands

  • hekaya login — opens the dashboard's CLI-token mint page; reads back the plaintext token (one-time reveal). Persists to ~/.hekaya/credentials.
  • hekaya scan — walks the working directory, detects framework, extracts text + route metadata, writes .hekaya/scan.json. Respects .gitignore.
  • 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.

Supported frameworks

  • React — JSX/TSX text nodes, file-based routes (Next.js / Remix / Vite plugins).
  • Angular — template i18n markers, component selector + route module map.
  • Generic — plain HTML scrape + sitemap discovery.

Auto-detected via .hekaya scan based on files in the project root.

Privacy

The 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.

Source

Monorepo: github.com/8xlabs-ai/hekaya.ai → packages/kb-cli/.

License

MIT