What it does

• Docks a chat panel next to any page, with the page as context. Ctrl Shift K opens it.
• Runs a coding agent in a local sidecar. The agent is Claude Code by default, or OpenAI's Codex, and it reads the project, its loaded modules and their skills.
• Edits pages through the Builder in Safe mode, or writes code in Code mode. It then typechecks and shows the result live.
• Saves every turn that touches the project as a change set you can review, undo and redo.
• Adds an Assistant module for owners, with the Overview, Changes, Activity, Skills and Settings pages.

The assistant is a development tool. With NODE_ENV=production, the backend starts no sidecar and the dashboard shows no assistant. The sidecar exits if you start it yourself in production.

Install

From the root of a project that already loads @antelopejs/dms, add the module with the AntelopeJS CLI:

ajs project modules add @antelopejs/dms-ai
ajs project modules add @antelopejs/dms-builder   # optional, turns on Safe mode

Quick start

Point the sidecar at the origin that the api module reserved:

// antelope.config.ts
"dms-ai": {
  source: { type: "package", package: "@antelopejs/dms-ai" },
  config: {
    backendUrl: "${@api.API_LOCAL_BASE_URL}",
  },
},

Claude Code runs with its own credentials, either its login or ANTHROPIC_API_KEY in the backend's environment. Codex runs on your ChatGPT plan and uses no OpenAI API key. To use Codex, install @openai/codex at the version that peerDependencies pins, then press Sign in with ChatGPT in Assistant › Settings. On a DMS that runs on another machine, finish the sign-in with Paste the return address.

Restart the backend, then the frontend. Sign in as an owner and press Ctrl Shift K (⌘ ⇧ K on macOS). To start the backend without the sidecar, set DMS_AI=0.

Requirements

The module needs a DMS backend in a release that implements the @antelopejs/interface-dms range in the table. The dashboard needs an @antelopejs/dms-frontend renderer in the range that engines["@antelopejs/dms-frontend"] of frontend-vue/package.json declares. The ajs dms CLI refuses to build the module with a renderer outside that range. @antelopejs/dms-builder is optional and turns on Safe mode.

Documentation

• Introduction
• Installation
• Configuration, with the agent providers, Codex, Safe mode, your own Claude Code session and remote access
• Usage
• Extending
• FAQ

The guide's sources live in docs/. The package ships its agent skills in skills/: dms-ai, dms-ai-code-mode, dms-builder-safe, dms-external-database and dms-page-design. antelopeJs.skills declares them, and the assistant loads them into its agent.

Contributing

Read CONTRIBUTING.md before you open a pull request.

One install from the repository root installs the backend, the shipped Vue frontend and the sidecar. Each of the three keeps its own lockfile. The playground is separate and needs its own install for local development. The builds use the installed dependencies and do not install them again.

pnpm install --frozen-lockfile
pnpm --dir playground install --frozen-lockfile --ignore-workspace
pnpm build
pnpm build:sidecar
pnpm dev            # playground backend
pnpm frontend:dev   # dashboard, in a second terminal
pnpm lint
pnpm test
pnpm test:node      # every backend suite, after a single build

Part of AntelopeJS DMS

This module installs into AntelopeJS DMS, the open-source back office. Every module adds its pages to the same dashboard, behind the same sign-in and roles.

License

Apache-2.0