team-reflect/local-brain

team-reflect-Profil

Letzte erfasste Quellaktivität: 9. September 2026 um 21:08

SkillsMP-Katalog aktualisiert: 17. Oktober 2026 um 00:09

gesammelte Skills: 3

GitHub-Stars: 11
GitHub-Forks: 2

README des Repositorys

README-Quelldatei: README.md

README-Quelldatei lesen

Vollständige README anzeigen

# Local Brain An agent-operated local brain with a private desktop UI. SQLite is the durable source of truth; AI agents read and write through the `brain` CLI and local skills. See [`docs/`](docs/README.md) for product and architecture docs, and [`docs/build/`](docs/build/manifest.md) for the implementation PR stack. ## Workspace layout ```text apps/ desktop/ Tauri 2 + React 19 desktop app src/ frontend (React, Vite, Tailwind v4) src-tauri/ Rust shell, IPC commands, AppError contract scripts/ sidecar build/staging cli/ the `brain` CLI (Rust, shipped as a Tauri sidecar) packages/ core/ TS product logic, IPC `call()` boundary, AppError contract db/ Kysely schema/types + read-only IPC dialect crates/ brain-schema/ durable SQLite migrations + open/migrate helpers skills/ bundled agent instructions, installed by the desktop app docs/ planning and architecture docs ``` The TypeScript split follows Reflect Open: `packages/core` owns product logic, React components and Rust commands stay thin, and TypeScript reaches SQLite through a Kysely-over-Tauri-IPC bridge. ## Prerequisites - **Node** >= 22 and **pnpm** 11 (`corepack enable` to match the pinned version) - **Rust** stable (`rustup`) with the Tauri 2 prerequisites for your OS — needed for the desktop shell, the `brain` CLI, and the schema crate - macOS is the initial target platform ## Setup ```bash pnpm install ``` ## Quality gates ```bash pnpm typecheck # tsc --noEmit across every TS package (turbo) pnpm lint # oxlint over apps + packages pnpm test # vitest across every TS package (turbo) pnpm check # typecheck + lint + test pnpm --filter @local-brain/desktop sidecar # once before compiling the desktop crate cargo check --workspace # Rust crates (desktop shell, CLI, schema) cargo test --workspace # CLI, desktop, and migration tests ``` For check/test runs only, prefix the sidecar command with `LOCAL_BRAIN_SIDECAR_MODE=stub` to stage the same placeholder used by CI. A real desktop launch or package needs the built sidecar; `pnpm tauri dev` and `pnpm tauri build` build it automatically. Generated database types and core integration tests replay the same migrations through `@local-brain/db/testing`. Run `pnpm --filter @local-brain/db db:codegen` after adding a migration; `pnpm check` verifies that the committed types match. ## Develop ```bash pnpm --filter @local-brain/desktop dev # Vite dev server only pnpm tauri dev # full desktop app (requires Rust + Tauri) cargo run -p brain-cli -- --brain /path/to/brain status cargo run -p brain-cli -- --brain /path/to/brain --json status ``` Select a brain folder with `--brain` or `BRAIN_ROOT`. For tests and diagnostics, `--db` and `BRAIN_DB` select the database file directly without either folder option. The Rust CLI reads and writes SQLite directly, using the same migrations as the desktop app; it does not execute the TypeScript core package. ## Conventions - Rust owns SQLite connections, migrations, transactions, and native primitives. - Every `#[tauri::command]` returns `Result<T, AppError>`; the frontend validates responses with zod at the single `call()` boundary in `@local-brain/core` and never imports `@tauri-apps/api` directly. - Kysely compiles SQL in TypeScript; Rust executes it. Multi-table writes run in Rust transactions, not through the Kysely bridge. - SQLite is durable user data — only derived tables (chunks, FTS, vectors) are rebuildable. Markdown is not the storage format.

README des Repositorys wird geladen…

Skills in diesem Repository

Softwareentwickler

1 Berufskategorien · 100% klassifiziert

Skill

Beruf

Beschreibung

Aktualisiert

brain

Softwareentwickler

Read from and write to the user's Local Brain, a private local-first personal CRM and intelligence database stored in SQLite. Use for remembering or finding people, organizations, projects, tasks, documents, interactions, transcripts, facts, memories, and…

Quellsprache: Englisch

2026-09-09

brain-task-review

Softwareentwickler

Reconcile Local Brain tasks against newer evidence, retire resolved or obsolete work, consolidate duplicates, and audit full backlog coverage. Use during daily imports or when asked to clean up stale tasks.

Quellsprache: Englisch

2026-09-09

brain-backfill

Softwareentwickler

Source-led first-run or large historical Local Brain import. Use when setting up a new brain from Gmail/GWS, Granola, WhatsApp, Reflect notes, Calendar, contacts, or other personal data sources, especially when the user asks for a comprehensive backfill.

Quellsprache: Englisch

2026-06-22

Es werden 3 von 3 gesammelten Skills angezeigt.

Mit einem KI-Assistenten installieren

Diesen Prompt kopieren und in den verwendeten KI-Assistenten einfügen.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/team-reflect/local-brain.