lobehub/lobehub

cli

LobeHub CLI (@lobehub/cli) development guide — commands, subcommands, architecture.

Quellsprache: Englisch

model-bank-metadata

Use for model knowledgeCutoff, family and generation metadata: onboarding, corrections, research and bulk backfills.

Quellsprache: Englisch

agent-testing-bot

Use for real bot-channel acceptance in Discord, Slack, Telegram, WeChat/Weixin, Lark/Feishu, QQ or iMessage on macOS. Extends acceptance with native chat apps.

Quellsprache: Englisch

full-text-search

Use for product search: FtsSearchRepo, pg_search/pg_like/Elasticsearch, mapping migrations, projections, Outbox sync, reindexing and performance. Excludes agent web search.

Quellsprache: Englisch

testing

Use for Vitest tests, mocks, coverage and failing-test diagnosis.

Quellsprache: Englisch

desktop

Electron desktop development guide — IPC handlers, controllers, preload scripts, window/menu management.

Quellsprache: Englisch

react

Use for TSX components, UI libraries, styling, state locality, layout, render performance and memoization.

Quellsprache: Englisch

source-layout

Use for where a file lives, how it is named, where its tests go, and how to split a source or test file over 800 lines (拆分大文件, 目录结构, 文件命名).

Quellsprache: Englisch

split-large-file

Refactor a source file over 800 lines into a directory of cohesive modules without changing behavior, test-first. Use when asked to split, decompose, or shrink a large file (拆分大文件, 拆文件, 重构大文件); with no file given, pick one.

Quellsprache: Englisch

acceptance

End-to-end verification and self-evidence for a delivery in any repository, with or without a preconfigured verify plan. Discover an existing plan when one was handed to this run; otherwise author checks and publish a standalone acceptance. Pick the proving…

Quellsprache: Englisch

zustand

Use for Zustand stores: state shapes and type sources, state-only stores with xActions classes, replica-backed list/detail data (@lobechat/replica), selectors, optimistic writes, and legacy slice/internal_* action composition.

Quellsprache: Englisch

desktop-security-update

Inspect, mark, or revoke vulnerable LobeHub Desktop versions through the existing release workflow and signed R2 security policy. Use for forced security updates across Stable, Canary, Beta, and Nightly.

Quellsprache: Englisch

ux-audit

Audit a page / surface against the Designing Interfaces pattern language + the ux skill checklists, then land findings. Three layers — static (code), visual (screenshots), dynamic (automated user journey + perf). Use to run a repeatable, standards-based UX…

Quellsprache: Englisch

ux

Use for product design principles and UX checks when designing or implementing user-facing flows.

Quellsprache: Englisch

agent-work

Use for the Agent Work output registry: registration, deduplication, cards, skill providers, CLI scanners and Work types.

Quellsprache: Englisch

builtin-tool

Use for LobeHub builtin agent tools: manifests, executors, runtimes, inspectors, renders, streaming and intervention.

Quellsprache: Englisch

store-data-structures

Explicit compatibility entry for Zustand data-shape guidance.

Quellsprache: Englisch

agent-runtime-hooks

Use for agent lifecycle hooks, tool mocks, intervention, sub-agent calls and context compression.

Quellsprache: Englisch

spa-routes

Use for SPA routes and page segments: Web/desktop/mobile/popup routers, redirects and src/routes-to-features boundaries.

Quellsprache: Englisch

data-fetching-architecture

Use for client APIs, SWR hooks, cache invalidation, async errors, useEffect migration, home first paint and persistent caches.

Quellsprache: Englisch

run-eval-harbor

Run and diagnose existing Harbor or FrontierHarness evaluations against local production LobeHub or LobeHub Cloud, on a local Docker host, SSH worker, or Runta. Use for eval infrastructure, target preflight, lh CLI injection, Harbor smoke or job runs, resume,…

Quellsprache: Englisch

i18n

Use for user-facing strings and react-i18next locale keys, namespaces, interpolation, translations or bun run i18n.

Quellsprache: Englisch

heterogeneous-agent

Use for external-agent launchers and execution identity, Claude Code/Codex adapters, IPC, event mapping, sessions, persistence and tool-call chains.

Quellsprache: Englisch

deep-review

Use for independent PR, diff or branch review; not explanations. Full multi-agent review requires an explicit deep-review request.

Quellsprache: Englisch

typescript

Use for TypeScript style and type safety when editing TS/TSX/MTS, including imports, async code and error suppression.

Quellsprache: Englisch

pr

Create a PR for the current branch (targets `canary` by default), including splitting one cross-layer branch into ordered stacked PRs so a lower layer (db / shared package / server TRPC) merges before its callers (desktop / CLI / UI). Use when the user asks…

Quellsprache: Englisch

cleanup-git-worktrees

Use for stale-worktree, Git registration and branch audits. Managed removal uses the repo lifecycle.

Quellsprache: Englisch

alint-ruleset

Maintain LobeHub's model-backed alint rule set in packages/alint: author a rule, calibrate its false positives against real source, decide its severity (warn vs error) from real PR data, and track its token cost. Use for adding or narrowing an alint rule,…

Quellsprache: Englisch

split-micro-app

Use for standalone micro apps: React Router SSR/SSG, Cloud overlays, Workers, CDN/R2, SEO/OG, gateway routes, previews, Docker integration and SSR bundle isolation.

Quellsprache: Englisch

design-prototype

Use for interactive HTML prototypes (交互原型) with the real LobeHub UI stack. Excludes production UI implementation.

Quellsprache: Englisch

add-model-provider

Add an AI model provider to LobeHub, including runtime integration, model cards, configuration, branding, documentation, and acceptance. Also use for provider documentation updates; adding models to an existing provider does not require a new provider…

Quellsprache: Englisch

chat-sdk

Use for multi-platform bots built with chat SDK: webhooks, mentions, slash commands, cards, modals and streaming.

Quellsprache: Englisch

db-migrations

Use for Drizzle migration rollout, online indexes, backfills, idempotent SQL and migration regeneration or rebase conflicts.

Quellsprache: Englisch

debug-package

Use for debug() logging, lobe-* namespaces, DEBUG/localStorage.debug configuration and log formatting.

Quellsprache: Englisch

drizzle

Use for Drizzle schemas and queries: tables, indexes, relations, joins and inferred types. Rollout belongs to db-migrations.

Quellsprache: Englisch

skills-audit

Audit .agents/skills SKILL.md files. Use for recurring checks of duplicate, overlapping, stale, inconsistent, or broken skills and merge/delete candidates.

Quellsprache: Englisch

upstash-workflow

Use for Upstash Workflow/QStash handlers, triggers, durable steps and async fan-out.

Quellsprache: Englisch

compose-atoms

Use for splitting heavy domains into capabilities (原子组件) across page, portal, share or micro-app hosts, sinking state (状态下沉) and replacing mode/readOnly flags. Simple component splits: react.

Quellsprache: Englisch

hotkey

Use for keyboard shortcuts, registration, key combinations, scope, conflicts and shortcut tooltips.

Quellsprache: Englisch

modal

Use for modals, dialogs and confirmations with createModal, confirmModal, ModalHost or base-ui modal APIs.

Quellsprache: Englisch