OpenClaw Control Center
Safety-first local control center for OpenClaw.
Why this exists
- One local place to see whether OpenClaw is healthy, busy, blocked, or drifting.
- Built for non-technical operators who need observability and certainty, not raw backend payloads.
- Safe first-run defaults:
- read-only by default
- local token auth by default
- mutation routes disabled by default
What you get
Overview: health, current state, decisions waiting, and operator-facing summariesUsage: usage, spend, subscription windows, and connector statusStaff: who is really working now versus only queuedTasks: current work, approvals, execution chains, and runtime evidenceDocumentsandMemory: source-backed workbenches scoped to active OpenClaw agents
Who it is for
- OpenClaw users who want one local control center for observability, usage, tasks, approvals, replay, documents, and memory
- teams running OpenClaw on one machine or a reachable local environment
- maintainers who want a public-ready, safety-first OpenClaw dashboard instead of a generic agent platform
Screenshots
Example UI from a local OpenClaw environment:
5-minute start
npm install
cp .env.example .env
npm run build
npm test
npm run smoke:ui
UI_MODE=true npm run dev
Then open:
http://127.0.0.1:4310/?section=overview&lang=enhttp://127.0.0.1:4310/?section=overview&lang=zh
For / 适用对象:
- Existing OpenClaw users who want a local control center for observability, usage, staff activity, tasks, approvals, replay, and documents.
- Teams running OpenClaw on the same machine or a reachable local environment.
- Not a generic dashboard for non-OpenClaw agent stacks.
Core constraints
- Only touches files in
control-center/. READONLY_MODE=trueby default.LOCAL_TOKEN_AUTH_REQUIRED=trueby default.IMPORT_MUTATION_ENABLED=falseby default.IMPORT_MUTATION_DRY_RUN=falseby default.- Import/export and all state-changing endpoints require a local token when auth is enabled.
- Approval actions are hard-gated (
APPROVAL_ACTIONS_ENABLED=falsedefault). - Approval actions are dry-run by default (
APPROVAL_ACTIONS_DRY_RUN=true). - No mutation of
~/.openclaw/openclaw.json.
Quick start
npm installcp .env.example .env- Keep safe defaults for the first run; only change
GATEWAY_URLor path overrides if your OpenClaw setup is non-standard. npm run buildnpm testnpm run smoke:uiUI_MODE=true npm run dev
English installation and onboarding
1. Before you start
You should already have:
- a working OpenClaw installation
- a reachable OpenClaw Gateway
- shell access with
nodeandnpm - read access to your OpenClaw home directory
For the richest dashboard data, it also helps if this machine has:
~/.openclaw~/.codex- a readable OpenClaw subscription snapshot, if your setup stores one outside the default locations
2. Install the project
git clone <your-repo-url>
cd control-center
npm install
cp .env.example .env
3. Configure .env
For a safe first run, keep the mutation guards in place.
Use this baseline:
GATEWAY_URL=ws://127.0.0.1:18789
READONLY_MODE=true
APPROVAL_ACTIONS_ENABLED=false
APPROVAL_ACTIONS_DRY_RUN=true
IMPORT_MUTATION_ENABLED=false
IMPORT_MUTATION_DRY_RUN=false
LOCAL_TOKEN_AUTH_REQUIRED=true
UI_MODE=false
UI_PORT=4310
# Optional only when your paths differ from the defaults:
# OPENCLAW_HOME=/path/to/.openclaw
# CODEX_HOME=/path/to/.codex
# OPENCLAW_SUBSCRIPTION_SNAPSHOT_PATH=/path/to/subscription.json
Change only these values if your environment needs it:
GATEWAY_URL: when your OpenClaw Gateway is not on the default local socketOPENCLAW_HOME: when OpenClaw is not stored in~/.openclawCODEX_HOME: when Codex data is not stored in~/.codexOPENCLAW_SUBSCRIPTION_SNAPSHOT_PATH: when your billing/subscription snapshot lives somewhere customUI_PORT: when4310is already in use
4. Optional: ask your own OpenClaw to prepare the setup
If you want OpenClaw to help configure the environment, give it this prompt:
You are helping me connect OpenClaw Control Center to this machine's OpenClaw installation.
Work only inside the control-center repository.
Do not modify application source code unless I explicitly ask.
Goal: prepare a safe first-run setup.
Please do the following:
1. Check whether the OpenClaw Gateway is reachable and tell me the correct gateway URL.
2. Confirm the correct OpenClaw home path and Codex home path on this machine.
3. Compare those paths with .env.example and create or update .env.
4. Keep these values safe for first run:
- READONLY_MODE=true
- LOCAL_TOKEN_AUTH_REQUIRED=true
- APPROVAL_ACTIONS_ENABLED=false
- IMPORT_MUTATION_ENABLED=false
5. Do not enable live import or approval mutations.
6. Do not change OpenClaw's own config.
7. At the end, print:
- the final env values you changed
- the exact commands I should run next
- the first dashboard pages I should open to confirm everything works
8. If any required path, process, or file is missing, stop and tell me exactly what is missing instead of guessing.
5. Verify the install
Run:
npm run build
npm test
npm run smoke:ui
Expected result:
- build passes
- tests pass
- UI smoke reports a local URL such as
http://127.0.0.1:<port>
6. Start the UI
UI_MODE=true npm run dev
Then open:
- English UI:
http://127.0.0.1:4310/?section=overview&lang=en - Chinese UI:
http://127.0.0.1:4310/?section=overview&lang=zh
If you changed UI_PORT, replace 4310 with your chosen port.
7. First-use checklist
On your first launch, check these pages in order:
Overview: the app opens and shows current system state.Usage: usage and subscription panels either show real numbers or a clear missing-connector state.Staff: live work status matches real active sessions.Tasks: current work, approvals, and execution-chain cards load without raw payload noise.DocumentsandMemory: the visible agent tabs match your active agents fromopenclaw.json.
8. If something looks wrong
- Empty live activity usually means
GATEWAY_URLis wrong or the OpenClaw Gateway is not running. - Missing
Documents / Memoryagents usually meansOPENCLAW_HOMEpoints to the wrong OpenClaw root oropenclaw.jsonis missing. - Missing usage/subscription data usually means
CODEX_HOMEorOPENCLAW_SUBSCRIPTION_SNAPSHOT_PATHneeds to be set. - If you only want a safe read-only dashboard, do not change the mutation defaults.
中文安装与上手
1. 开始前准备
你最好已经有:
- 一个正常可用的 OpenClaw 安装
- 一个可连通的 OpenClaw Gateway
- 当前机器上的
node和npm - 对 OpenClaw 主目录的读取权限
如果你希望 用量 / 订阅 这类信息更完整,当前机器最好还能读到:
~/.openclaw~/.codex- 你的 OpenClaw 订阅快照文件,尤其是它不在默认位置时
2. 安装项目
git clone <你的仓库地址>
cd control-center
npm install
cp .env.example .env
3. 配置 .env
第一次接入建议保持安全默认值,不要急着开写操作。
可以先用这份基线配置:
GATEWAY_URL=ws://127.0.0.1:18789
READONLY_MODE=true
APPROVAL_ACTIONS_ENABLED=false
APPROVAL_ACTIONS_DRY_RUN=true
IMPORT_MUTATION_ENABLED=false
IMPORT_MUTATION_DRY_RUN=false
LOCAL_TOKEN_AUTH_REQUIRED=true
UI_MODE=false
UI_PORT=4310
# 只有在你的路径不是默认值时才需要设置:
# OPENCLAW_HOME=/path/to/.openclaw
# CODEX_HOME=/path/to/.codex
# OPENCLAW_SUBSCRIPTION_SNAPSHOT_PATH=/path/to/subscription.json
只有这些情况才需要改:
GATEWAY_URL:你的 OpenClaw Gateway 不在默认本地地址OPENCLAW_HOME:你的 OpenClaw 目录不在~/.openclawCODEX_HOME:你的 Codex 数据不在~/.codexOPENCLAW_SUBSCRIPTION_SNAPSHOT_PATH:你的订阅或账单快照文件放在自定义位置UI_PORT:4310端口已被占用
4. 可选:让你自己的 OpenClaw 帮你配置
如果你想让自己的 OpenClaw 帮你把环境接好,可以直接给它这段提示词:
你现在要帮我把 OpenClaw Control Center 接到这台机器自己的 OpenClaw 环境上。
只允许在 control-center 仓库里工作。
除非我明确要求,否则不要修改应用源码。
目标是完成一次安全的首次接入配置。
请按下面步骤执行:
1. 检查 OpenClaw Gateway 是否可达,并告诉我正确的 gateway URL。
2. 确认这台机器上正确的 OpenClaw 主目录和 Codex 主目录。
3. 对照 .env.example,创建或更新 .env。
4. 第一次接入时必须保持这些值:
- READONLY_MODE=true
- LOCAL_TOKEN_AUTH_REQUIRED=true
- APPROVAL_ACTIONS_ENABLED=false
- IMPORT_MUTATION_ENABLED=false
5. 不要开启 live import,也不要开启 approval mutation。
6. 不要改 OpenClaw 自己的配置文件。
7. 完成后输出:
- 你实际修改了哪些 env 值
- 我下一步应该执行的准确命令
- 我应该先打开哪些页面来确认接入成功
8. 如果缺少必要的路径、进程或文件,不要猜,直接明确告诉我缺什么。
5. 验证安装
执行:
npm run build
npm test
npm run smoke:ui
预期结果:
- build 通过
- test 通过
- UI smoke 输出一个本地地址,比如
http://127.0.0.1:<port>
6. 启动界面
UI_MODE=true npm run dev
然后打开:
- 中文界面:
http://127.0.0.1:4310/?section=overview&lang=zh - 英文界面:
http://127.0.0.1:4310/?section=overview&lang=en
如果你改了 UI_PORT,把上面的 4310 换成你自己的端口。
7. 首次上手检查顺序
第一次打开后,建议按这个顺序检查:
总览:页面能正常打开,并且能看到当前系统状态。用量:能看到真实数字,或者至少能看到明确的“数据源未连接”状态。员工:实时工作状态和真实 active session 大致一致。任务:当前工作、待审批、执行链卡片都能正常加载,而且不会吐原始 payload。文档和记忆:看到的 agent 标签应该和你的openclaw.json活跃 agent 一致。
8. 如果看起来不对
- 实时活动全空,通常是
GATEWAY_URL错了,或者 OpenClaw Gateway 没启动。 文档 / 记忆的 agent 范围不对,通常是OPENCLAW_HOME指错了,或者openclaw.json不可读。用量 / 订阅没数据,通常是CODEX_HOME或OPENCLAW_SUBSCRIPTION_SNAPSHOT_PATH没配对。- 如果你只是想先安全观察,不要改动默认的只读和 mutation 开关。
Local commands
npm run buildnpm run devnpm run dev:continuousnpm run dev:uinpm run smoke:uinpm run command:backup-exportnpm run command:import-validate -- runtime/exports/<file>.jsonnpm run command:acks-prunenpm testnpm run validate
For protected command modes (command:backup-export, command:import-validate, command:acks-prune), set LOCAL_API_TOKEN=<token> unless LOCAL_TOKEN_AUTH_REQUIRED=false.
Repository hygiene (Phase 113, Open-source release readiness)
- Repo now ships with
.gitignore,LICENSE, and publishable package metadata. - Gateway connectivity is configurable via
GATEWAY_URLinstead of being hard-wired to one local socket. - PM2, mission harness, workflow, and verifier examples now use repo-relative paths and environment-injected secrets only.
- Public docs now refer to generic
~/.openclaw/...locations instead of machine-specific home directories. - Run
npm run release:auditbefore every public push. - See
docs/PUBLISHING.mdfor the recommended standalone-repo release flow.
Local HTTP endpoints
GET /snapshot: raw snapshot JSONGET /projects: list projects with optional query filtersstatus,ownerGET /api/projects: same as/projectsfor compatibilityPOST /api/projects: create project (projectId,title, optionalstatus,owner)PATCH /api/projects/:projectId: update project title/status/ownerGET /tasks: flattened task list with optional query filtersstatus,owner,projectGET /api/tasks: same as/tasksfor compatibilityPOST /api/tasks: create task with schema validationPATCH /api/tasks/:taskId/status: update task status with schema validationGET /sessions: paginated session visibility list with optional filtersstate,agentId,q, and pagination paramspage,pageSize,historyLimitGET /sessions/:id: per-session JSON detail with latest history entries (historyLimitquery supported)GET /api/sessions/:id: explicit API alias for per-session JSON detailGET /session/:id: localized session drill-down UI page (lang=en|zh) with latest messages, execution-chain evidence, and safe truncationGET /api/sessions: compatibility endpoint for/sessionsGET /api/commander/exceptions: exceptions-only summary (blocked/errors/pending approvals/over-budget/tasks-due)GET /exceptions: routed exceptions feed with levels (info,warn,action-required), sorted by severity then newest eventGET /done-checklist: final integration checklist + readiness scoring (observability/governance/collaboration/security)GET /api/done-checklist: API alias for done checklistGET /api/action-queue: notification center queue derived from exceptions feed + ack state + relevant session/task/project linksGET /api/action-queue/acks/prune-preview: token-gated dry-run preview of stale ack prune counts (before/removed/after, no state mutation)POST /api/action-queue/:itemId/ack: acknowledge an action-required queue item (persisted), optionalttlMinutesorsnoozeUntilto auto-expire ack stateGET /graph: project-task-session linkage graph JSON (for future Gameboy view)GET /view/pixel-state.json: pixel-ready adapter state (rooms,entities,links) for future Gameboy canvasGET /usage-cost: product route alias that redirects to/?section=usage-costGET /api/usage-cost: usage/billing observability snapshot (period totals, context windows, breakdowns, burn-rate, subscription consumed/remaining/cycle, connector TODOs)GET /export/state.json: bundled export with sessions/tasks/projects/budgets/exceptions + persisted debug snapshot + backup bundle inruntime/exports/(requires local token auth)POST /api/import/dry-run: dry-run validator for export bundles (fileNameor inlinebundle) with zero state mutation (requires local token auth)POST /api/import/live: optional live import mutation endpoint (high-risk, local-only); requires local token +IMPORT_MUTATION_ENABLED=true, blocked in readonly unlessdryRun=true, and now returns validation errors instead of500for badfileNamepathsGET /notifications/preview: notification policy preview with quiet-hours + severity routingGET /cron: cron overview with next run and health summaryGET /healthz: system health payload (build info + snapshot freshness + monitor lag)GET /digest/latest: rendered HTML page from latest markdown digest fileGET /api/ui/preferences: persisted dashboard UI preferences (runtime/ui-preferences.json)PATCH /api/ui/preferences: update dashboard UI preferences (compactStatusStrip,quickFilter,taskFilters)GET /api/search/tasks: safe substring search over tasks (q,limit), withcount= total matches andreturned= current response sizeGET /api/search/projects: safe substring search over projects (q,limit), withcount= total matches andreturned= current response sizeGET /api/search/sessions: safe substring search over sessions (q,limit), withcount= total matches,returned= current response size, and live-session merge parity with/sessionsGET /api/search/exceptions: safe substring search over exception feed (q,limit), withcount= total matches andreturned= current response sizeGET /api/replay/index: replay/debug index from timeline + digests + export snapshots + export bundles, optionalfrom/toISO time window filters, plus per-sourcestats(total,returned,filteredOut, window-vs-limit breakdown,latencyMs,latencyBucketsMswithp50/p95,totalSizeBytes,returnedSizeBytes)GET /api/docs: route + schema summary endpointGET /docs: localized docs index page (read-only) with direct return path to theDocumentssectionGET /docs/readme|runbook|architecture|progress: local markdown docs views (read-only,langaccepted for index/back-link flow)POST /api/approvals/:approvalId/approve: approval action service (gate + dry-run + audit)POST /api/approvals/:approvalId/reject: rejection action service (gate + dry-run + audit)GET /audit: local audit timeline page (newest-first, severity filter)GET /api/audit: audit timeline JSON (severity=all|info|warn|action-required|error)
Dashboard highlights (Phase 14)
- Home page includes inline scoped search UI wired to
/api/search/*. - Home page replay/export visibility card now shows returned/filtered counts and latency/size indicators from
/api/replay/index. - Guard table shows explicit disabled/enabled badges and linked local docs references.
Dashboard highlights (Phase 107, Approvals/replay/tool-activity correctness sweep)
- Approval counts now use the full live approval set:
- sidebar and task-hub decision counts no longer under-report when approval previews are truncated
- approval preview lists stay short but now make it explicit when only the latest subset is shown
- Replay visibility chips now show total available history:
- timeline events
- daily digests
- export snapshots
- backup bundles
- Overview tool activity detail now loads actual session evidence:
- it no longer claims there are no tool-call sessions while the same page shows active tool-call counts
- User-facing parity routes no longer advertise deprecated dashboard sections:
- approvals route points to the task hub decision lane
- replay route points to
/audit
Dashboard highlights (Phase 110, Docs/memory active-agent scope alignment)
DocumentsandMemorynow follow active OpenClaw agent config instead of stale workspace folders:- facets are resolved from
~/.openclaw/openclaw.jsonfirst - removed agents no longer appear just because an old folder still exists under
workspace/agents/ - root OpenClaw files are now shown as
Maininstead of共享
- facets are resolved from
- Editable file content remains source-of-truth current:
- file lists still read live filesystem metadata (
updatedAt, size, path) - opening a file reads the current source file
- saving a file writes directly back to that same source file
- file lists still read live filesystem metadata (
Dashboard highlights (Phase 111, Execution-chain readability cleanup)
Execution chaincards no longer surface raw JSON payloads as the visible headline or summary.- Unmapped isolated-run cards now use stable labels such as
Main · Cron 隔离执行. - JSON-like payloads are summarized into short readable lines:
成功 · 查询 30 · 成功 30失败 · 错误 locked成功 · 扫描 120 · 入选 2 · 发送 2
- Long titles and session keys now wrap/clamp inside the card instead of pushing badges out of place.
Dashboard highlights (Phase 112, Staff status freshness semantics)
- Staff
Working / 工作中now means live execution, not just “still owns unfinished tasks”. - Agents with backlog but no live session now stay in standby semantics instead of looking falsely active.
- Staff work labels now separate:
- live work:
Working on / 正在处理什么 - queued next task:
Next up / 下一项
- live work:
- Staff/recent-activity cache remains short-lived at about
3s; live-session polling baseline remains5s.
Dashboard highlights (Phase 114, Execution-chain card hardening)
- Execution-chain cards no longer allow raw JSON-like payloads to become visible titles.
- Structured payload-shaped titles are converted into short human summaries or stable fallback labels instead.
- Long titles, meta rows, and badge rails are now overflow-safe inside the card grid.
Dashboard highlights (Phase 115, Apple-native card elevation tune)
- Page canvas is slightly cooler and quieter so foreground cards stand out more cleanly.
- Core cards now use brighter layered fills, crisper borders, and deeper but still restrained elevation.
- The hierarchy is unchanged; this is a visual polish pass, not a layout rewrite.
Dashboard highlights (Phase 116, Config-truthful document and memory scopes)
Documents / Memoryno longer revive deleted agents just because stale folders still remain on disk.- Valid active-agent config remains the only truth source for those facet buttons.
- If config becomes unreadable, the workbench now falls back conservatively to
Mainonly instead of showing stale agent folders.
Dashboard highlights (Phase 106, Cold-path cache coalescing)
- Correctness stays unified across Overview / Settings / Usage:
- no return to split summary/full quota logic
- repeat navigations keep the same usage/quota truth when the underlying execution state is unchanged
- Heavy evidence scans are now reused instead of recomputed per page:
- runtime usage logs
- Codex subscription/quota telemetry
- digest history
- OpenClaw cron name catalog
- UI startup now primes dashboard caches, and concurrent page opens share the same heavy build work.
- In local smoke:
- back-to-back
Overviewrenders dropped to about0.41s - back-to-back
Usagerenders dropped to about0.41s - after one priming hit, concurrent
Overview / Settings / Usagecompleted in about1.13s
- back-to-back
Dashboard highlights (Phase 105, Observability correctness alignment)
- Overview / Tasks / Settings / Usage now share one usage/quota truth source:
- the same today-usage number
- the same Codex quota windows
- the same subscription-status judgement
- Active-session counts are aligned across:
- overview KPI
- certainty card
- sidebar / summary strips
- Task certainty no longer depends on only the first recent-session page:
- linked session evidence is loaded for the visible task set
- task detail pages no longer stop at the first 6 linked sessions
- Detail links now keep the current UI language when opening task / cron drill-down pages.
Dashboard highlights (Phase 15, UX v2)
- Home dashboard is now organized into six operator tabs with persistent left navigation:
OverviewOffice SpaceProjects/TasksAlertsReplay/AuditSettings
- UI moved to a colorful pixel-arcade visual style with dual sidebars (navigation + context rail).
- New
Office Spaceview shows who is busy on what, grouped by office zones. - Agent cards now include automatic animal identities derived from agent name semantics, with deterministic fallback mapping.
- Empty/zero-heavy blocks are softened:
- non-actionable zero states are minimized
- user-facing empty states now say
Not activated yet.
- Home copy was rewritten from debug-heavy wording to operator-focused language while preserving all existing routes and backend behavior.
Dashboard highlights (Phase 22, Usage/Cost parity surfaces)
- Added
Usage & Costsection in the primary sidebar IA. - Added Overview card-level usage/cost pulse:
- period totals (
today,7d,30d) - request-count source state
- burn-rate headline
- period totals (
- Added dedicated Usage & Cost dashboard section:
- context window visibility per active session/agent (absolute tokens + % when context catalog is available)
- pace/trend labels + warning thresholds
- usage/cost breakdown by agent, project, model, provider
- budget burn-rate status and alert messaging
- Added graceful unavailable-state behavior:
- explicit
Data source not connectedlabels for disconnected metrics (instead of fake zeros) - connector TODO list surfaced in Settings
- explicit
- Added usage adapter endpoint:
GET /api/usage-cost
Dashboard highlights (Phase 25, Mission Control v3)
- UI visual reset to polished pixel-office style:
- design-token based palette/spacing/radius/shadow system
- layered office background grid + glow depth
- responsive desktop/mobile hierarchy with subtle card/status motion
- Navigation and copy reset for operator clarity:
Command Deck,Usage & Billing,Pixel Office,Work Board,Decisions,Timeline,Control Room- reduced technical wording on primary surfaces
- advanced links preserved under explicit disclosure
- Mac parity surfaces panel added with status + route entry for:
- conversations, approvals/decision queue, cron, projects/tasks, usage/cost, replay/audit, health/digest, export/import dry-run safety, pixel adapter
- Full roster office model:
- best-effort OpenClaw roster read from
~/.openclaw/openclaw.jsonviasrc/runtime/agent-roster.ts - office floor now renders desk/zone occupancy and includes known agents beyond active sessions
- best-effort OpenClaw roster read from
- Subscription usage/remaining best-effort integration:
- adapter support in
src/runtime/usage-cost.tsfor connected/partial/not_connected states - UI now shows consumed/remaining/limit/cycle/source and explicit connection targets when unavailable
- adapter support in
Dashboard highlights (Phase 68, Plain-language certainty)
- Added
Information certaintycard to Overview and Settings:- tells non-technical operators which parts of the picture are trustworthy now
- calls out remaining blind spots in plain language
- Added
Execution certaintyboard to Tasks:- scores whether each in-flight task is backed by real execution evidence
- separates
evidence is strongfromneeds follow-upandevidence is weak
- Task detail pages now act as evidence pages:
- certainty judgement
- linked session evidence and recent activity summaries
API validation/error envelope
- API mutating routes require
Content-Type: application/json. - Import/export and mutating routes require local token auth by default:
- header:
x-local-token: <LOCAL_API_TOKEN> - or
Authorization: Bearer <LOCAL_API_TOKEN>
- header:
- Strict API query validation rejects unknown query keys.
- JSON errors use a consistent envelope:
{"ok":false,"requestId":"...","error":{"code":"...","status":<http>,"message":"...","issues":[],"requestId":"..."}}
- JSON responses include
requestIdand all responses includex-request-idheader for correlation.
Live import warning
POST /api/import/liveis intentionally disabled by default.- Do not enable it unless you are doing a controlled local restore test.
- Live mode mutates local runtime stores (
runtime/projects.json,runtime/tasks.json,runtime/budgets.json). - Keep
READONLY_MODE=trueandIMPORT_MUTATION_ENABLED=falsein normal operation.
Runtime files
runtime/last-snapshot.jsonruntime/timeline.logruntime/projects.jsonruntime/tasks.jsonruntime/budgets.jsonruntime/notification-policy.jsonruntime/model-context-catalog.jsonruntime/ui-preferences.jsonruntime/acks.jsonruntime/approval-actions.logruntime/operation-audit.logruntime/digests/YYYY-MM-DD.jsonruntime/digests/YYYY-MM-DD.mdruntime/export-snapshots/*.jsonruntime/exports/*.json
Docs
docs/ARCHITECTURE.mddocs/RUNBOOK.mddocs/PROGRESS.md