dms-ai
Sets up and troubleshoots @antelopejs/dms-ai, the AI development assistant of the AntelopeJS DMS (chat panel, sidecar running Claude Code or Codex, change sets with undo, audit log and skills pages under /modules/ai). Use when installing or configuring dms-ai (backendUrl, DMS_AI, providers, Codex), when the assistant is offline, or when a module must ship skills to it through antelopeJs.skills.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- icon
- i-lucide-sparkles
- name
- dms-ai
- tags
- [ "ai", "assistant", "sidecar", "claude-code", "codex", "skills" ]
- category
- ai
- description
- Sets up and troubleshoots @antelopejs/dms-ai, the AI development assistant of the AntelopeJS DMS (chat panel, sidecar running Claude Code or Codex, change sets with undo, audit log and skills pages under /modules/ai). Use when installing or configuring dms-ai (backendUrl, DMS_AI, providers, Codex), when the assistant is offline, or when a module must ship skills to it through antelopeJs.skills.
02 资源文件 1
- 参考文档cases.json1.2 KB
03 SKILL.md 正文
dms-ai
An owner-only development assistant. The backend starts a sidecar (child process, 127.0.0.1 only) that runs the agent in the project folder; the browser reaches it only through the DMS frontend server. User docs: https://dms.antelopejs.com/docs/modules/ai (source: docs/ of this package).
Setup
ajs project modules add @antelopejs/dms-ai; configbackendUrl: "${@api.API_LOCAL_BASE_URL}".- The frontend server proxies
/ai/**to the backend with the session (backendProxies). See the package README for requirements. - Load
@antelopejs/dms-buildertoo: chats then default to Safe mode (Builder tools only, typechecked writes). Code mode allows file edits and commands under the approval mode. - Claude Code is the default provider. Codex needs
@openai/codexat the exact version inpeerDependenciesand a ChatGPT sign-in (Assistant › Settings; on a remote DMS the 127.0.0.1 return page fails to load and its address is pasted with Paste the return address; stored per user in~/.config/dms-ai/chatgpt-auth.json,OPENAI_API_KEYis ignored); a provider that cannot run fails the turn, never falls back.
Skills
The sidecar loads every directory a loaded module declares in package.json antelopeJs.skills (and ~/.claude/skills when Settings allow it). Ship a module's skill as skills/<name>/SKILL.md with name, description, icon, category, tags: [a, b] frontmatter, add skills to files. Two skills with one name: one is Shadowed.
Gotchas
- Refuses to run with
NODE_ENV=production;DMS_AI=0starts the backend without the sidecar. - Overview and Activity open with the DMS
PageToolbar(period only, no live: "updated" + refresh); their selectors sharerememberKey: "ai". The Overview offers previous period / previous year / none in a menu (comparisonControl: "menu"); its KPI, series, allowed and top-tools routes forwardcompareFrom/compareTo(absent under none); the top lists carry a per-rowdelta./ai/activityfilters on thefrom/tothe table sends; the CSV export ignores them. - Offline assistant: Restart on the Overview; lists and settings answer
503while the sidecar is down. - Remote over plain HTTP: start the frontend with
DMS_COOKIE_SECURE=false. - Deleting pages, tables, fields or queries asks in every mode, Auto review included. So does a database mapping that would remove a page, and so does every edit of a git hook file (anything inside a
.gitdirectory,.husky/*, a lefthook config file,.pre-commit-config.yaml), whatever the dependencies toggle says. With Codex, the sandbox is read-only in every mode, so every write asks, and the card for such a file offers no rule. - Claude Code defaults to Auto review (a safety check approves routine file edits and web access); every shell command, scheduled task and tool it does not know still asks the person, and so does every edit of
package.json, a lockfile,pnpm-workspace.yaml,.npmrc,.pnpmfile.cjs,.yarnrc,.yarnrc.ymlorbunfig.tomlunless the person turned off the dependency approval. Codex defaults to Ask first and has no Auto review. Ask first asks before every command, read-only ones included, and before any change outside the Builder. Accept edits applies file edits unasked, except dependency and git hook files, and asks before every command; with Codex it works as Ask first, asking before every file edit and any command that writes. - Undo is limited to the checkpoint retention (7, 30 or 90 days).
04 同仓库更多 Skills
dms-page-design
Designs DMS pages that show data, through the Builder tools. Use when building or changing an analytics, stats or dashboard page or a table page, choosing a chart or a KPI for some data, picking a page's period, naming a page and its icon, or deciding how a table displays (badges, prices, relation labels, status tabs, saved views, kanban, cards, footer totals, KPI cards above the table).
dms-external-database
Connects a DMS project to a client's existing database, runs the Builder's analysis of it, settles what the analysis could not decide from the catalog and aggregates, generates TableViews through the Builder, names them and gives each the table features its data supports, and always builds an analytics dashboard first in the menu. Use when the user wants pages over a database the project does not own, PostgreSQL, MongoDB or RethinkDB ("plug in our client's Postgres", "map their Mongo database", "generate the admin for this database", "finish the mapping the Builder proposed").
dms-builder-safe
Builds or modifies AntelopeJS DMS admin pages through the Builder MCP tools instead of raw code edits. Use when the generation mode is "safe", or when the user wants predictable, typechecked page edits (add/configure/move/remove blocks, create pages and categories).
dms-ai-code-mode
Runs the dms-ai Code-mode loop for changing a DMS page in code while the user watches it in the dashboard overlay, with the list_pages, navigate_to_page, find_pages_using, typecheck and query_logs host tools. Use when the dms-ai generation mode is Code and a change touches a rendered page, or when the user allows Code mode after a Builder tool answered opaque_target or unsupported.
page-builder
Create and modify DMS pages. Use when the user wants to add or edit a page.
verify-dms-ai
Drive the AntelopeJS dms-ai module (the AI assistant: its sidecar, Overview, Changes, Activity, Skills and Settings pages, the Codex sign-in banner and the owner-only routes) the way the platform owner does, inside a DMS with free ports and its own MongoDB database, and report a verdict with evidence. Use to prove a change to AntelopeJS/dms-ai works before merge, or to verify a PR. A turn with Claude Code or Codex needs credentials a run never holds: that part is NOT VERIFIED, so a verdict is never a plain PASS.