@surething/cockpit 1.0.275 → 1.0.276

package/.next-prod/types/app/api/bots/route.ts

@@ -0,0 +1,353 @@
+// File: /home/runner/work/cockpit/cockpit/src/app/api/bots/route.ts
+import * as entry from '../../../../../src/app/api/bots/route.js'
+import type { NextRequest } from 'next/server.js'
+
+import type { InstantConfigForTypeCheckInternal, Prefetch } from 'next/dist/build/segment-config/app/app-segment-config.js'
+
+type TEntry = typeof import('../../../../../src/app/api/bots/route.js')
+
+type SegmentParams<T extends Object = any> = T extends Record<string, any>
+  ? { [K in keyof T]: T[K] extends string ? string | string[] | undefined : never }
+  : T
+
+// Check that the entry is a valid entry
+checkFields<Diff<{
+  GET?: Function
+  HEAD?: Function
+  OPTIONS?: Function
+  POST?: Function
+  PUT?: Function
+  DELETE?: Function
+  PATCH?: Function
+  config?: {}
+  generateStaticParams?: Function
+  instant?: InstantConfigForTypeCheckInternal
+  prefetch?: Prefetch
+  unstable_dynamicStaleTime?: number
+  revalidate?: RevalidateRange<TEntry> | false
+  dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
+  dynamicParams?: boolean
+  fetchCache?: 'auto' | 'force-no-store' | 'only-no-store' | 'default-no-store' | 'default-cache' | 'only-cache' | 'force-cache'
+  /** @deprecated The `preferredRegion` config is deprecated. Remove this export. */
+  preferredRegion?: 'auto' | 'global' | 'home' | string | string[]
+  runtime?: 'nodejs' | 'experimental-edge' | 'edge'
+  maxDuration?: number
+  
+}, TEntry, ''>>()
+
+type RouteContext = { params: Promise<SegmentParams> }
+// Check the prop type of the entry function
+if ('GET' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'GET'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'GET'>>
+      },
+      'GET'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'GET'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'GET'>>
+      },
+      'GET'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'GET',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'GET',
+        __return_type__: ReturnType<MaybeField<TEntry, 'GET'>>
+      },
+      'GET'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('HEAD' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'HEAD'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'HEAD'>>
+      },
+      'HEAD'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'HEAD'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'HEAD'>>
+      },
+      'HEAD'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'HEAD',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'HEAD',
+        __return_type__: ReturnType<MaybeField<TEntry, 'HEAD'>>
+      },
+      'HEAD'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('OPTIONS' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'OPTIONS'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'OPTIONS'>>
+      },
+      'OPTIONS'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'OPTIONS'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'OPTIONS'>>
+      },
+      'OPTIONS'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'OPTIONS',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'OPTIONS',
+        __return_type__: ReturnType<MaybeField<TEntry, 'OPTIONS'>>
+      },
+      'OPTIONS'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('POST' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'POST'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'POST'>>
+      },
+      'POST'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'POST'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'POST'>>
+      },
+      'POST'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'POST',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'POST',
+        __return_type__: ReturnType<MaybeField<TEntry, 'POST'>>
+      },
+      'POST'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('PUT' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'PUT'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'PUT'>>
+      },
+      'PUT'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'PUT'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'PUT'>>
+      },
+      'PUT'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'PUT',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'PUT',
+        __return_type__: ReturnType<MaybeField<TEntry, 'PUT'>>
+      },
+      'PUT'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('DELETE' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'DELETE'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'DELETE'>>
+      },
+      'DELETE'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'DELETE'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'DELETE'>>
+      },
+      'DELETE'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'DELETE',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'DELETE',
+        __return_type__: ReturnType<MaybeField<TEntry, 'DELETE'>>
+      },
+      'DELETE'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('PATCH' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'PATCH'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'PATCH'>>
+      },
+      'PATCH'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'PATCH'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'PATCH'>>
+      },
+      'PATCH'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'PATCH',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'PATCH',
+        __return_type__: ReturnType<MaybeField<TEntry, 'PATCH'>>
+      },
+      'PATCH'
+    >
+  >()
+}
+
+// Check the arguments and return type of the generateStaticParams function
+if ('generateStaticParams' in entry) {
+  checkFields<Diff<{ params: SegmentParams }, FirstArg<MaybeField<TEntry, 'generateStaticParams'>>, 'generateStaticParams'>>()
+  checkFields<Diff<{ __tag__: 'generateStaticParams', __return_type__: any[] | Promise<any[]> }, { __tag__: 'generateStaticParams', __return_type__: ReturnType<MaybeField<TEntry, 'generateStaticParams'>> }>>()
+}
+
+export interface PageProps {
+  params?: Promise<SegmentParams>
+  searchParams?: Promise<any>
+}
+export interface LayoutProps {
+  children?: React.ReactNode
+
+  params?: Promise<SegmentParams>
+}
+
+// =============
+// Utility types
+type RevalidateRange<T> = T extends { revalidate: any } ? NonNegative<T['revalidate']> : never
+
+// If T is unknown or any, it will be an empty {} type. Otherwise, it will be the same as Omit<T, keyof Base>.
+type OmitWithTag<T, K extends keyof any, _M> = Omit<T, K>
+type Diff<Base, T extends Base, Message extends string = ''> = 0 extends (1 & T) ? {} : OmitWithTag<T, keyof Base, Message>
+
+type FirstArg<T extends Function> = T extends (...args: [infer T, any]) => any ? unknown extends T ? any : T : never
+type SecondArg<T extends Function> = T extends (...args: [any, infer T]) => any ? unknown extends T ? any : T : never
+type MaybeField<T, K extends string> = T extends { [k in K]: infer G } ? G extends Function ? G : never : never
+
+type ParamCheck<T> = {
+  __tag__: string
+  __param_position__: string
+  __param_type__: T
+}
+
+function checkFields<_ extends { [k in keyof any]: never }>() {}
+
+// https://github.com/sindresorhus/type-fest
+type Numeric = number | bigint
+type Zero = 0 | 0n
+type Negative<T extends Numeric> = T extends Zero ? never : `${T}` extends `-${string}` ? T : never
+type NonNegative<T extends Numeric> = T extends Zero ? T : Negative<T> extends never ? T : '__invalid_negative_number__'

package/.next-prod/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/m" | "/project" | "/review/[id]"
-type AppRouteHandlerRoutes = "/api/agent/test" | "/api/bash" | "/api/chat" | "/api/chat/codex" | "/api/chat/deepseek" | "/api/chat/glm" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/chat/stop" | "/api/claude-stats" | "/api/commands" | "/api/comments" | "/api/db/columns" | "/api/db/connect" | "/api/db/disconnect" | "/api/db/export" | "/api/db/query" | "/api/db/schemas" | "/api/deepseek/balance" | "/api/deepseek/credentials" | "/api/deepseek/models" | "/api/dev/spans" | "/api/extension/version" | "/api/file" | "/api/files/blame" | "/api/files/clipboard" | "/api/files/copy" | "/api/files/delete" | "/api/files/expanded" | "/api/files/index" | "/api/files/init" | "/api/files/paste" | "/api/files/read" | "/api/files/readdir" | "/api/files/recent" | "/api/files/save" | "/api/files/search" | "/api/files/stat" | "/api/files/text" | "/api/git/blob" | "/api/git/branch-diff" | "/api/git/branches" | "/api/git/commit-diff" | "/api/git/commits" | "/api/git/current-branch" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/glm/credentials" | "/api/glm/models" | "/api/glm/usage" | "/api/global-state" | "/api/health" | "/api/html-apps" | "/api/html-apps/[id]" | "/api/instructions/config" | "/api/kimi/credentials" | "/api/kimi/models" | "/api/kimi/usage" | "/api/lsp/definition" | "/api/lsp/hover" | "/api/lsp/references" | "/api/lsp/status" | "/api/lsp/warmup" | "/api/mysql/columns" | "/api/mysql/connect" | "/api/mysql/disconnect" | "/api/mysql/export" | "/api/mysql/query" | "/api/mysql/schemas" | "/api/neo4j/connect" | "/api/neo4j/disconnect" | "/api/neo4j/query" | "/api/neo4j/schema" | "/api/note" | "/api/ollama/config" | "/api/ollama/models" | "/api/ollama/start" | "/api/open-cursor" | "/api/open-vscode" | "/api/pick-folder" | "/api/pinned-sessions" | "/api/project-settings" | "/api/project-state" | "/api/projectGraph/affected" | "/api/projectGraph/callees" | "/api/projectGraph/callers" | "/api/projectGraph/coedit" | "/api/projectGraph/context" | "/api/projectGraph/file" | "/api/projectGraph/file-functions" | "/api/projectGraph/impact" | "/api/projectGraph/related" | "/api/projectGraph/risk" | "/api/projectGraph/search" | "/api/projects" | "/api/push/public-key" | "/api/push/subscribe" | "/api/push/unsubscribe" | "/api/redis/command" | "/api/redis/connect" | "/api/redis/delete" | "/api/redis/disconnect" | "/api/redis/get" | "/api/redis/keys" | "/api/redis/set" | "/api/restart" | "/api/review" | "/api/review/[id]" | "/api/review/[id]/comments" | "/api/review/[id]/replies" | "/api/review/identify" | "/api/review/order" | "/api/review/share-info" | "/api/review/users" | "/api/scheduled-tasks" | "/api/services/config" | "/api/services/scripts" | "/api/session-by-path" | "/api/session/[sessionId]/fork" | "/api/session/[sessionId]/history" | "/api/session/[sessionId]/turn" | "/api/session/user-messages" | "/api/sessions" | "/api/sessions/delegate" | "/api/sessions/projects" | "/api/sessions/projects/[encodedPath]" | "/api/sessions/search" | "/api/sessions/status" | "/api/settings" | "/api/shutdown" | "/api/skills" | "/api/skills/[id]" | "/api/skills/content" | "/api/snapshots" | "/api/snapshots/blob" | "/api/snapshots/diff" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/update" | "/api/update-state" | "/api/version" | "/apps/[...path]"
+type AppRouteHandlerRoutes = "/api/agent/test" | "/api/bash" | "/api/bots" | "/api/bots/[id]" | "/api/chat" | "/api/chat/codex" | "/api/chat/deepseek" | "/api/chat/glm" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/chat/stop" | "/api/claude-stats" | "/api/commands" | "/api/comments" | "/api/db/columns" | "/api/db/connect" | "/api/db/disconnect" | "/api/db/export" | "/api/db/query" | "/api/db/schemas" | "/api/deepseek/balance" | "/api/deepseek/credentials" | "/api/deepseek/models" | "/api/dev/spans" | "/api/extension/version" | "/api/file" | "/api/files/blame" | "/api/files/clipboard" | "/api/files/copy" | "/api/files/delete" | "/api/files/expanded" | "/api/files/index" | "/api/files/init" | "/api/files/paste" | "/api/files/read" | "/api/files/readdir" | "/api/files/recent" | "/api/files/save" | "/api/files/search" | "/api/files/stat" | "/api/files/text" | "/api/git/blob" | "/api/git/branch-diff" | "/api/git/branches" | "/api/git/commit-diff" | "/api/git/commits" | "/api/git/current-branch" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/glm/credentials" | "/api/glm/models" | "/api/glm/usage" | "/api/global-state" | "/api/health" | "/api/html-apps" | "/api/html-apps/[id]" | "/api/instructions/config" | "/api/kimi/credentials" | "/api/kimi/models" | "/api/kimi/usage" | "/api/lsp/definition" | "/api/lsp/hover" | "/api/lsp/references" | "/api/lsp/status" | "/api/lsp/warmup" | "/api/mysql/columns" | "/api/mysql/connect" | "/api/mysql/disconnect" | "/api/mysql/export" | "/api/mysql/query" | "/api/mysql/schemas" | "/api/neo4j/connect" | "/api/neo4j/disconnect" | "/api/neo4j/query" | "/api/neo4j/schema" | "/api/note" | "/api/ollama/config" | "/api/ollama/models" | "/api/ollama/start" | "/api/open-cursor" | "/api/open-vscode" | "/api/pick-folder" | "/api/pinned-sessions" | "/api/project-settings" | "/api/project-state" | "/api/projectGraph/affected" | "/api/projectGraph/callees" | "/api/projectGraph/callers" | "/api/projectGraph/coedit" | "/api/projectGraph/context" | "/api/projectGraph/file" | "/api/projectGraph/file-functions" | "/api/projectGraph/impact" | "/api/projectGraph/related" | "/api/projectGraph/risk" | "/api/projectGraph/search" | "/api/projects" | "/api/push/public-key" | "/api/push/subscribe" | "/api/push/unsubscribe" | "/api/redis/command" | "/api/redis/connect" | "/api/redis/delete" | "/api/redis/disconnect" | "/api/redis/get" | "/api/redis/keys" | "/api/redis/set" | "/api/restart" | "/api/review" | "/api/review/[id]" | "/api/review/[id]/comments" | "/api/review/[id]/replies" | "/api/review/identify" | "/api/review/order" | "/api/review/share-info" | "/api/review/users" | "/api/scheduled-tasks" | "/api/services/config" | "/api/services/scripts" | "/api/session-by-path" | "/api/session/[sessionId]/fork" | "/api/session/[sessionId]/history" | "/api/session/[sessionId]/turn" | "/api/session/user-messages" | "/api/sessions" | "/api/sessions/delegate" | "/api/sessions/projects" | "/api/sessions/projects/[encodedPath]" | "/api/sessions/search" | "/api/sessions/status" | "/api/settings" | "/api/shutdown" | "/api/skills" | "/api/skills/[id]" | "/api/skills/content" | "/api/snapshots" | "/api/snapshots/blob" | "/api/snapshots/diff" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/update" | "/api/update-state" | "/api/version" | "/apps/[...path]"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -14,6 +14,8 @@ interface ParamMap {
   "/": {}
   "/api/agent/test": {}
   "/api/bash": {}
+  "/api/bots": {}
+  "/api/bots/[id]": { "id": string; }
   "/api/chat": {}
   "/api/chat/codex": {}
   "/api/chat/deepseek": {}

package/.next-prod/types/validator.ts

@@ -101,6 +101,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/bots/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/bots/[id]">> = Specific
+  const handler = {} as typeof import("../../src/app/api/bots/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/bots/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/bots">> = Specific
+  const handler = {} as typeof import("../../src/app/api/bots/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/chat/codex/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/chat/codex">> = Specific

package/README.md

@@ -46,6 +46,7 @@ Cockpit is the instrument panel. It does **not** replace Claude Code; it stands
 | One session at a time, terminal chaos at 3+ projects | **Multi-project tabs**, parallel agent sessions, red-dot inbox, desktop notifications |
 | Image attachments are awkward | Drop / paste images straight into chat |
 | "What was I debugging yesterday?" | Cmd+K cross-project session browser, pinning, forking; `/ss` finds any past session from one sentence |
+| Every subagent starts with a blank slate | **Bots**: persistent, file-native subagents you tag with `@name`; each runs in its own inspectable session |
 | Agent can't reach your browser / DB | **Smart Bubbles**: Chrome, PostgreSQL, MySQL, Redis — drivable by the agent |
 | Reading an unfamiliar repo means a 90-min file-tree scavenger hunt | **Code Map** chip view — caller / callee pins, click to walk the call graph |
 | Reviewing AI output is friction | **LAN-shared review pages**, line-level comments, send any comment back as AI context |
@@ -99,6 +100,7 @@ An honest snapshot as of July 2026 — each tool wins somewhere. Spotted an erro
 - Session **pinning, forking**, cross-project session browser (Cmd+K)
 - `/ss` — **find any past session** (any project, engine or date) from a one-line description; the reply links straight to it
 - `/dl` — **delegate a sub-task** to a new session in another directory and/or on another engine, without waiting; ask later how it went
+- **Bots** — tag a persistent, file-native subagent with `@name`; it runs in a separate session with its own identity, context, commitments, and Skills
 - **Per-tool-call snapshots** — every file-touching tool call is snapshotted (shadow git, fully local); review each reply's changes as a git-history-style timeline, including what `Bash` did
 - `!command` prefix to run shell from chat — output piped back as context
 - Image attachments, code references, token usage tracking
@@ -151,9 +153,20 @@ An honest snapshot as of July 2026 — each tool wins somewhere. Spotted an erro
 - Invoke with `/skill-name` from chat
 - All managed from a single Skills sidebar
 
+### Bots — persistent subagents
+
+- Create a Bot with `/bot`, then register its ordinary local directory from the Bots panel or its `BOT.md`
+- Tag it into any task with `@name`; every turn runs in a separate, inspectable session and returns a link
+- Memory is deliberate: normal turns are read-only, and files change only when you explicitly ask to remember, update, correct, or forget
+- Attach an existing Skill with `@name attach /path/to/SKILL.md`; review stale memory with `@name review`
+- Bot directories stay local and portable Markdown — no hidden database, upload, or vendor lock-in
+
+[Read the Bots documentation](https://opencockpit.dev/en/docs/agent/bots/).
+
 ## Use cases
 
 - **Solo dev, multi-repo:** "I have a refactor running in API, tests writing in Web, and a bug investigation in Pipeline — all at once, all visible."
+- **A specialist that remembers:** tag `@product` for a roadmap decision today and again next month; it reads the same explicit, reviewable context without polluting the main chat.
 - **Day one in an unfamiliar repo:** Open it in Code Map, click through caller/callee pins, walk the auth flow in five clicks instead of a 90-minute file-tree scavenger hunt.
 - **Two-person team:** Senior reviews via LAN-shared review page, no GitHub PR round-trip needed for in-progress work.
 - **Team on a shared dev box:** self-host one Cockpit where the code lives — every teammate opens a browser, takes a seat, and runs their own AI sessions in their own project / worktree.

package/README.zh.md

@@ -46,6 +46,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 | 一次只能开一个会话，3+ 项目就乱 | **多项目标签页**、并发 Agent 会话、红点收件箱、桌面通知 |
 | 图片附件麻烦 | 拖拽 / 粘贴图片直接进对话 |
 | "我昨天调的那个 bug 在哪？" | Cmd+K 跨项目会话浏览，会话固定 / 分叉；`/ss` 一句话找回任意历史会话 |
+| 每个子代理都从空白开始 | **Bots**：用 `@name` 叫进任务的持久化、文件原生子代理；每次都在可检查的独立会话中运行 |
 | Agent 够不到浏览器 / 数据库 | **智能气泡**：Chrome、PostgreSQL、MySQL、Redis —— Agent 可驱动 |
 | 读陌生仓库就是 90 分钟"找地鼠" | **代码地图（Code Map）** chip 视图 —— caller / callee pin 一点即跳 |
 | AI 输出审阅低效 | **局域网共享评审页**、行级评论、任意评论可回喂给 AI |
@@ -99,6 +100,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 - 会话**固定 / 分叉**，跨项目会话浏览（Cmd+K）
 - `/ss` —— 一句话描述，**找回任意历史会话**（跨项目、跨引擎、不限日期），回复里直接给可打开的链接
 - `/dl` —— 把子任务**委派**给另一个目录 / 另一个引擎的新会话，不用等；之后随时问进展
+- **Bots** —— 用 `@name` 叫进一个持久化、文件原生子代理；它在独立会话中带着自己的身份、上下文、承诺和 Skills 工作
 - **工具调用级快照** —— 每次碰文件的工具调用都会打快照（影子 git，全本地）；按 git 历史式时间线逐调用审阅每条回复的变更，`Bash` 改了什么也看得到
 - `!command` 前缀直接执行 shell —— 输出回流为对话上下文
 - 图片附件、代码引用、Token 用量统计
@@ -151,9 +153,20 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 - 在对话中用 `/skill-name` 直接调用
 - 所有技能在统一 Skills 侧边栏管理
 
+### Bots —— 持久化子代理
+
+- 用 `/bot` 创建 Bot，再从 Bots 面板或 `BOT.md` 注册这个普通本地目录
+- 用 `@name` 叫它进任务；每轮都在独立、可检查的会话中运行，并返回链接
+- 记忆是有意的：普通任务默认只读，只有明确要求记住、更新、纠正或删除时才改文件
+- 用 `@name 装上 /path/to/SKILL.md` 关联现有 Skill；用 `@name 复盘一下` 检查过期记忆
+- Bot 目录一直是本地、可迁移的 Markdown，没有隐藏数据库、上传或厂商锁定
+
+[查看 Bots 文档](https://opencockpit.dev/zh/docs/agent/bots/)。
+
 ## 使用场景
 
 - **独立开发者多仓并行：** "API 在重构、Web 在写测试、Pipeline 在排 bug —— 同时跑、同时可见。"
+- **一个真正记得住的专家：** 今天让 `@product` 记下路线图决策，下个月再叫它时读的还是同一份显式、可审阅上下文，不污染主会话。
 - **新仓库的第一天：** 用 Code Map 打开它，沿着 caller / callee pin 一路点过去 —— 鉴权流程 5 次点击就走完，不再是 90 分钟的"文件树找地鼠"。
 - **二人小团队：** Senior 用局域网共享评审页 review，半成品代码不用绕 GitHub PR。
 - **共享开发机团队：** 在代码所在的机器上自托管一个 Cockpit —— 队友打开浏览器就能一起飞，各自在自己的项目 / worktree 上跑 AI 会话。

package/bots/README.md

@@ -0,0 +1,86 @@
+# Built-in Bots
+
+One directory per Bot, each with a `BOT.md` at its root — the same shape a user's own
+Bot has (`/bot` creates those). The **directory set IS the registry**: both consumers
+derive from `listBuiltinBots()` in
+`packages/feature/agent/src/server/lib/builtinBots.ts`, so adding a built-in Bot is
+`mkdir` + files, with no TypeScript list to keep in sync.
+
+This file is a file, not a directory, so the scan never sees it as a Bot.
+
+**These directories are seeds, not homes.** Each one is installed into
+`~/.cockpit/bots/<name>` on first listing, and *that copy* is the Bot: it is the path
+the panel prints, the folder button opens and `@name` dispatch reads. Nothing is ever
+written back here. See the module comment in `builtinBots.ts` for why, and read
+"Staying up to date" below before assuming a copy goes stale.
+
+## What makes them different from registered Bots
+
+|  | built-in (`/bots`) | registered (`bot.json`) |
+|---|---|---|
+| discovered by | directory scan of the install root | absolute paths in `~/.cockpit/bot.json` |
+| in the Bots panel | yes, with a "Built-in" chip, no delete button | yes, removable |
+| `@name` dispatch | yes — and survives a corrupt `bot.json` | yes |
+| lives in | `~/.cockpit/bots/<name>`, installed from the seed | wherever the user made it |
+| writable | yes — it is an ordinary copy | yes |
+
+Built-ins are merged into the listing at read time and never written into `bot.json`:
+their path moves with the install (npm global dir vs repo checkout, and again per
+`COCKPIT_HOME`), so a persisted row would become a dead entry the user cannot delete
+after the next upgrade. On a name clash the built-in wins, and `POST /api/bots` with a
+built-in's path reports it as already present rather than writing a row.
+
+## Staying up to date
+
+The install root cannot host a Bot: it is root-owned under `npm i -g`, replaced
+wholesale on upgrade, and shared by every `COCKPIT_HOME`, so a Bot living there could
+not be opened, edited or written to. Hence the copy. The obvious cost of any copy is
+drift — it stops receiving `BOT.md` updates the day it is made — and that is not paid
+here, because the install is *tracked, file by file*.
+`~/.cockpit/bots/.builtin-installs.json` holds the hash of every file installed, and
+each one falls into one of four cases when a newer version ships:
+
+| The file | On upgrade |
+|---|---|
+| still exactly as we wrote it | replaced with the new version |
+| changed since we wrote it (by the user or by the Bot) | left alone, at this and every later version |
+| gone from the new version, ours and untouched | deleted, so it stops instructing the Bot |
+| never installed by us — the Bot's own memory | untouched, and not our business |
+
+Per file, not per Bot, and the reason is memory: a Bot with memory writes into its own
+directory on an ordinary turn, so judging the tree as a whole would read the first
+remembered fact as "the user has taken this over" and cut the Bot off from every later
+fix. Per file, memory lands in paths we never installed and the shipped files go on
+being maintained. Deleting the folder resets everything and starts tracking afresh.
+
+Updates are staged and swapped in whole, and are skipped entirely while a Bot session
+holds `.locks/write` — nothing here is urgent enough to race a Bot mid-write.
+
+Built-in *skills* solve the same problem differently — they rewrite their copy on
+every dispatch — which works only because a skill directory has no user state in it.
+A Bot's directory does, which is why this one compares before it writes.
+
+## Memory
+
+A built-in Bot's directory is writable like any other, so `bot-turn`'s writing protocol
+applies unchanged and a built-in may keep memory. Two things are true of a built-in's
+memory in particular, and its `BOT.md` is the only place they can be said:
+
+- **It lives in that user's copy only.** Nothing is shared between installs, and
+  nothing comes back to this repository.
+- **What must never be recorded is Bot-specific.** `writing.md` already rules out
+  anything re-readable from the source system; each built-in has to name what its
+  source system is. `cockpit-helper` names opencockpit.dev — it remembers the person
+  it works with, and never the site, because the site is always its own newest copy
+  one fetch away while a stored copy is a stale answer waiting to be given.
+
+A built-in that has nothing worth remembering should say so in its `BOT.md` rather
+than leaving the question open: an empty `memory/` invites a session to fill it.
+
+## Adding one
+
+1. `mkdir bots/<name>` with a `BOT.md` (frontmatter: `name`, `description` — the
+   description is what `@` autocomplete shows). The directory name is the `@name` and
+   the installed folder name, so it must match the frontmatter `name`.
+2. Say in it whether the Bot keeps memory, as `cockpit-helper/BOT.md` does.
+3. Nothing else. `package.json#files` already ships `bots`, and no list needs editing.