# dotcms

> One command to connect an AI coding agent to a dotCMS instance.

Latest version **26.9.17-2** (published 2026-09-17) · 0 weekly downloads

## Install

```sh
npm install dotcms
pnpm add dotcms
yarn add dotcms
bun add dotcms
```

Provides the command `dotcms`.

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 26.9.17-2 |
| Published | 2026-09-17 |
| First published | 2019-03-05 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 7 |
| Unpacked size | 54.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | nollymar, devdotcms |

## Links

- npm: https://www.npmjs.com/package/dotcms
- npm.io page: https://npm.io/package/dotcms

## Dependencies (7)

- [ora](https://npm.io/package/ora.md) ^9.0.0
- [chalk](https://npm.io/package/chalk.md) ^5.6.2
- [cfonts](https://npm.io/package/cfonts.md) ^3.3.1
- [inquirer](https://npm.io/package/inquirer.md) ^13.0.1
- [commander](https://npm.io/package/commander.md) ^14.0.2
- [smol-toml](https://npm.io/package/smol-toml.md) ^1.8.0
- [jsonc-parser](https://npm.io/package/jsonc-parser.md) ^3.3.1

## Recent versions

- 26.9.17-2 (latest) — 2026-09-17
- 26.9.14-1-next.2702 (next) — 2026-09-16
- 26.9.17-1 — 2026-09-17
- 26.9.14-1 — 2026-09-14
- 26.9.11-1 — 2026-09-12
- 26.9.9-1-next.2669 — 2026-09-11
- 26.9.9-1-next.2665 — 2026-09-10
- 26.9.9-1 — 2026-09-09
- 26.9.3-1-next.2657 — 2026-09-08
- 0.2.1 — 2026-09-07
- 0.2.0 — 2026-09-04
- 0.0.21 — 2022-10-10
- 0.0.20 — 2022-10-07
- 0.0.19 — 2022-10-06
- 0.0.18 — 2021-04-09
- … 17 more at https://npm.io/package/dotcms/versions

## README

# dotcms

One command to connect an AI coding agent to a dotCMS instance.

```bash
npx dotcms agent setup
```

It asks where your instance is, how to authenticate, and which editors to wire up — then mints
and verifies a token, writes the dotCMS MCP server into each editor's own config file, installs
the dotCMS skills, and launches the server to confirm it responds before reporting success.

Replaces four manual steps: find the admin panel, mint a token by hand, hand-edit whichever
config file your editor reads, install the skills separately.

## Supported editors

Claude Code · Cursor · VS Code (Copilot) · Codex · Antigravity · Devin · OpenCode

Installed editors are detected and used by default; `--agent <id>` selects specific ones.

## Authentication

Two mutually exclusive modes. Passing both is a usage error, not a silent preference.

```bash
# mint a token from credentials
npx dotcms agent setup --url https://demo.dotcms.com --user admin@dotcms.com --password '…'

# or use a token you already have
npx dotcms agent setup --url https://demo.dotcms.com --authToken '…'
```

The URL plus one auth mode are the only required inputs — supply both and the command runs
without prompting, whether or not a terminal is attached.

> Passing a secret as a flag makes it visible in the process list and shell history. Prefer
> `DOTCMS_PASSWORD` / `DOTCMS_AUTH_TOKEN`, or let it prompt.

## Scope

Writes to the **current folder** by default, so each project can point at its own instance.
`-g/--global` writes to your user account instead. Folder scope offers to add the files it
touched to `.gitignore`, because they contain a token.

## Where the token goes

Only into the editor config files listed in the summary, restricted to your user where the
platform supports it. It is never logged in full, never passed as a process argument, and a
password is never written anywhere.

## Status

Not yet released. See `specs/37390-dotcms-agent-setup/` for the specification.

---
_Source: https://npm.io/package/dotcms · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._