AGENT SKILL

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
所属仓库
AntelopeJS/dms-ai
最近更新
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

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; config backendUrl: "${@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-builder too: 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/codex at the exact version in peerDependencies and 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_KEY is 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=0 starts the backend without the sidecar.
  • Overview and Activity open with the DMS PageToolbar (period only, no live: "updated" + refresh); their selectors share rememberKey: "ai". The Overview offers previous period / previous year / none in a menu (comparisonControl: "menu"); its KPI, series, allowed and top-tools routes forward compareFrom / compareTo (absent under none); the top lists carry a per-row delta. /ai/activity filters on the from / to the table sends; the CSV export ignores them.
  • Offline assistant: Restart on the Overview; lists and settings answer 503 while 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 .git directory, .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.yml or bunfig.toml unless 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

AntelopeJS
AntelopeJS/dms-ai

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).

★ 2
AntelopeJS
AntelopeJS/dms-ai

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").

★ 2
AntelopeJS
AntelopeJS/dms-ai

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).

★ 2
AntelopeJS
AntelopeJS/dms-ai

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.

★ 2
AntelopeJS
AntelopeJS/dms-ai

page-builder

Create and modify DMS pages. Use when the user wants to add or edit a page.

★ 2
AntelopeJS
AntelopeJS/dms-ai

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.

★ 2