llaab
finografic/llaab
🌱 LLAAB: Order out of chaos by turning unstructured information into structured, executable knowledge. Local-first TypeScript monorepo: YouTube ingestion pipeline, typed vault nodes, LLM router, agent orchestration, and MCP server.
Instalação
npx convez-ai finografic/llaab1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
🌱 LLAAB
Local-first learning loop: structured vault nodes, governed LLM calls, and persisted runs.
macOS persistent local app
If you want LLAAB available in the browser at any time, the supported local setup is:
- Bun API service on
http://127.0.0.1:8888 - Vite client on
http://llaab.localhost:3000 launchdfor login-time persistence- SwiftBar for a menu bar control
Required installs
-
Install the core runtimes:
brew install node pnpm yt-dlp swiftbar brew install oven-sh/bun/bunThis repo currently expects Node 24.x.
-
Install repo dependencies:
pnpm install -
Build the standalone client once:
pnpm --filter @llaab/client build
Persistent-service scripts
The repo includes macOS helper scripts in scripts/macos/:
start-persistent-server.shstart-persistent-client.shllaab-service.shllaab-swiftbar.15s.sh
These are intended to be used with user LaunchAgents:
~/Library/LaunchAgents/com.llaab.server.plist~/Library/LaunchAgents/com.llaab.client.plist~/Library/LaunchAgents/com.llaab.icons.plist
Once installed, useful controls are:
scripts/macos/llaab-service.sh start
scripts/macos/llaab-service.sh stop
scripts/macos/llaab-service.sh restart
scripts/macos/llaab-service.sh repair-client
scripts/macos/llaab-service.sh status
SwiftBar
Set the SwiftBar plugin folder to:
~/Library/Application Support/SwiftBar/Plugins
The LLAAB plugin can then expose quick actions such as:
- open app
- open ingest
- open icons
- repair client
- restart services
- inspect logs
Notes
llaab.localhostis the low-friction friendly local hostname. No reverse proxy is required.- This persistent setup intentionally runs outside LLAAB itself. The app does not own an always-on scheduler or watcher.
- The persistent client uses a staged "last-known-good" runtime build, not a live in-place rebuild of the served output.
See
docs/process/PERSISTENT_LOCAL_RUNTIME.md.
Installation
-
Runtime: Node.js and pnpm (see
package.jsonfor the workspacepackageManagerversion). -
Dependencies: from the repo root:
pnpm install -
YouTube ingestion (required only for that path): the pipeline shells out to yt-dlp for metadata and subtitles. It must be installed separately and available on your
PATHin the same environment you use to run ingestion (e.g. terminal, CI, or IDE-integrated shell).# macOS (Homebrew) brew install yt-dlp which yt-dlp yt-dlp --versionIf
yt-dlpis missing, ingestion fails withyt-dlp: command not foundeven when the video URL is valid in a browser. -
Optional: Bun is used in repo scripts for quick one-off runs; install it if you use the snippet below.
Development
From the repo root:
pnpm dev
Runs the workspace dev stack (including the Vite client at http://localhost:3000 — see apps/client/README.md).
Client UI stack
apps/client now uses:
- Tailwind CSS v4
- shadcn/ui
- an app-local theme preset applied directly in the client workspace
The client no longer depends on PandaCSS or @finografic/design-system.
Adding shadcn components
Components are installed into packages/ui/src/components/ and imported via @llaab/ui/components/<name>.
Run the add command from apps/client so that apps/client/components.json provides the correct
registry and path configuration:
cd apps/client
pnpm dlx shadcn@latest add <component-name>
Browse available components first with:
pnpm dlx shadcn@latest view @shadcn
Installed components use @llaab/ui/lib/utils for cn() and @llaab/ui peer deps — no extra
wiring needed. For tooltip, wrap the relevant React island root with <TooltipProvider>.
Icon selector (@finografic/icons)
Customize which Lucide icons are available to the client UI. Run from the repo root (not apps/client):
pnpm icons
This starts the icons API server (http://localhost:5001) and the lucide-manager picker in the browser. On first run, icons.config.json is created at the repo root from the published DS default set; each save regenerates icons.generated.ts there.
| File | Notes |
|---|---|
icons.config.json | Source of truth — commit |
icons.generated.ts | Generated — commit (recommended) so builds work without the server |
lucide-manager.config.json | Written on startup — gitignored |
Root package.json already lists @finografic/icons, @finografic/lucide-manager, and concurrently as devDependencies. Wire imports in apps/client from icons.generated.ts (path relative to your app). To change icons for all Finografic apps, edit defaults in the design-system repo and release @finografic/icons.
YouTube ingestion
Prerequisite (repeat): yt-dlp must be installed and on PATH (see Installation step 3). Browsers do not satisfy this—the CLI invokes yt-dlp, not the browser.
From the repo root, after pnpm install:
pnpm exec bun -e "
import { ingestYouTube } from './packages/skills/src/ingest-youtube.ts';
await ingestYouTube({
url: 'https://www.youtube.com/watch?v=VIDEO_ID',
title: 'Optional title',
tags: ['trial'],
});
"
- Vault output defaults to
./vaultunder the current working directory (override withLLAAB_VAULTif you use a custom vault root). - Duplicates: the same YouTube
videoIdreuses the existing transcript node and skips re-fetching (seedocs/05_CONTROL_LAYER_AND_EXECUTION_MODEL.md).
Further reading
- Control layer and execution checklist:
docs/05_CONTROL_LAYER_AND_EXECUTION_MODEL.md - Ubiquitous language:
LLAAB_GLOSSARY.md
License
MIT © Justin Rankin