Prerequisites

Check with node --version before you start. At least one LLM provider is required — without either an OpenRouter key or a running Ollama, ingest / query / chat / lint all fail. If you only use Ollama, no OpenRouter key is needed.

Install + run

Three paths. Pick one.

Hosted — try without installing

The hosted version lives at llmwiki.cc. No install, no Node, no OpenRouter account required to look around — sign up, click around, start ingesting. Currently in waitlist: hosted product launches as paid tiers when the waitlist signals demand. Join the list on the site if you want an email when it goes live.

For everyone who'd rather run it themselves (the local-first promise this project was built on stays untouched), the two install paths below are the canonical way:

Quick start — install the CLI (recommended)

npm install -g @syasas/llm-wiki
llm-wiki start

That's it — no git clone, no monorepo, ~30 second install. The CLI auto-initializes your wiki folder, picks a free port (3737 by default), and opens the browser. Verified on macOS / Linux (incl. WSL) / Windows.

Package on npm: npmjs.com/package/@syasas/llm-wiki. Release notes + tarball mirror: GitHub Releases. If npm is unavailable for some reason, you can install directly from the GitHub tarball: npm install -g https://github.com/ddsyasas/llm-wiki/releases/download/v1.2.3/syasas-llm-wiki-1.2.3.tgz.

`llm-wiki: command not found` after install

The package installed fine — npm just put the binary somewhere your shell isn't looking. Common on WSL Ubuntu when Node was installed via apt with a non-standard npm prefix. Diagnostic:

```bash

Per-OS install notes

macOS — verified end-to-end. Works out of the box with Node from nodejs.org or nvm. Xcode Command Line Tools are usually already present; if npm install complains: xcode-select --install.

Linux (Ubuntu / Debian / Fedora / Arch / WSL) — verified end-to-end. If npm install -g fails on the native deps (better-sqlite3, keytar), install build tools first:

```bash

Probe install + OpenRouter connectivity

llm-wiki doctor

Building a publishable tarball

Want to package the app as a standalone npm tarball you can host yourself (or publish under your own scope)? After pnpm install:

```bash pnpm --filter @llm-wiki/web build:publish # produces apps/web/dist-publish/ cd apps/web/dist-publish npm pack # ~28MB tarball, fully self-contained

Uninstalling

The app is a Next.js server plus a SQLite metadata cache. To remove it:

```bash

Screenshots

Home — per-wiki page / source / chat counts, cumulative LLM spend (click → cross-wiki dashboard), and the four primary actions. Footer chips reach every meta-surface (About, Help, Developers, Dashboard).

Settings + multi-wiki

/settings — one-line wiki topic (the LLM reads this on every operation), optional approval gate for ingest, theme picker, default models per operation slot.

/settings → Costs — cumulative tokens + spend per (model, operation) pair. The Cost (recorded) column populates as new LLM calls land; historical rows get backfilled from the pricing table on next startup.

Header chip → dropdown with the active wiki (topic + folder path), plus quick links to Create / Manage. Same actions are reachable from ⌘K ("Switch to…" group) and /dashboard (per-wiki cards with Switch buttons).

---

Settings

Five model slots tunable per-operation: ingest / query / chat / lint / vision. Per-slot provider picker (new in v1.2): choose OpenRouter (cloud, BYOK, pay-as-you-go) or Ollama (Local) (your own machine, free) per slot — mix and match. Curated model dropdowns for each provider plus a custom-slug field for anything else. If any slot uses Ollama, a heads-up banner appears with a link to the /local-models setup guide. Light / dark / auto theme. OpenRouter key stored in OS keychain when available.

---

Remove the global config (OpenRouter key file-fallback + recent-wiki list)

rm -rf ~/.llm-wiki/ # macOS / Linux / WSL Remove-Item -Recurse -Force $HOME\.llm-wiki # Windows PowerShell

Optionally delete the wiki folder itself (it's just markdown — you may want to keep it)

rm -rf ~/llm-wiki-default ```

If you used the OS keychain for your API key (the default), also delete the llm-wiki / openrouter-api-key entry from Keychain Access (macOS) / GNOME Keyring (Linux) / Credential Manager (Windows).

If you used Ollama and want to free disk space, also remove the downloaded models: ollama list to see them, ollama rm <name> per model, or uninstall Ollama itself (brew uninstall ollama on macOS) to remove everything in ~/.ollama/.

Your wiki folder is plain markdown — keep it, open in Obsidian / VS Code / vim, sync with git or iCloud, archive it. The app leaving doesn't take your knowledge with it.