Unrag

Unrag is a RAG installer that adds small, auditable, drop-in primitives (ingest/retrieve + adapters) directly into your codebase as vendored source files.

This repository is a Turborepo + Bun workspaces monorepo.

Repo structure

• packages/unrag: the publishable npm package and CLI (unrag) plus the embedded registry/** templates it installs.
• apps/web: Next.js + Fumadocs site (landing + documentation).

Local development

Install deps:

bun install

Utility scripts

Export Excalidraw diagrams

There’s a small helper script to export .excalidraw.json files to PNG. It expects excalidraw-brute-export-cli to be available on your PATH.

bun run export:excalidraw -- --output ./output path/to/file1.excalidraw.json path/to/file2.excalidraw.json

Run everything:

bun run build
bun run test

Run the docs site:

cd apps/web
bun run dev

Try the CLI locally (link)

cd packages/unrag
bun run build
bun link

Then in any project:

bun link unrag
bunx unrag@latest init

Releases (Changesets)

• Create a changeset:

bun run changeset

• Version packages:

bun run version-packages

Push to main. GitHub Actions will open a Version PR and publish after merge (requires NPM_TOKEN secret).