Install dr-cli

Step 1 — Install an AI assistant

dr-cli is designed to be driven by an AI coding assistant — you describe what you want in natural language, the assistant picks the right dr command and runs it. Any of these works:

• Claude Code (recommended)
• Gemini CLI
• Codex CLI

Install whichever you prefer (or several) following the official quickstart, then verify:

claude --version    # if you installed Claude Code
gemini --version    # if you installed Gemini CLI
codex --version     # if you installed Codex CLI

Once your assistant and dr-cli are installed (Steps 2–3), the universal setup is to open a new folder and run dr skill init-project from inside it. That wires the dr-cli skill into whichever assistant you launch from that folder — see Step 4.

Step 2 — Prerequisites

Node.js 18 or newer — npm ships with Node, no other tools required. Check what you have:

node --version

If it prints v18.x.x or higher, you're set — jump straight to the install section. Otherwise expand the platform-specific Node install instructions inside each tab below.

Note: Option A (the one-shot script in each tab) installs Node for you automatically if it's missing — you only need the manual Node steps if you're going with Option B.

Step 3 — Install dr-cli for your platform

powershell -ExecutionPolicy Bypass -Command "irm https://drcli.datarails.com/cli/install.ps1 | iex"

winget install -e --id OpenJS.NodeJS.LTS

node --version
npm --version

npm install -g @datarails-ai/dr-cli --registry https://datarails.jfrog.io/artifactory/api/npm/dr-cli-virtual

curl -fsSL https://drcli.datarails.com/cli/install.sh | bash

brew install node@20
echo 'export PATH="$(brew --prefix node@20)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

sudo dnf install -y nodejs:20

node --version
npm --version

npm install -g @datarails-ai/dr-cli --registry https://datarails.jfrog.io/artifactory/api/npm/dr-cli-virtual

Step 4 — Use with your AI assistant

dr-cli ships with an embedded skill — the npm install in Step 3 automatically dropped a copy under each AI assistant directory it found in your home folder, so any session on this machine can drive the CLI using natural-language prompts like "log me into DEV and show me unmapped LUT items for customer Acme".

Where the skill landed:

• Claude Code → ~/.claude/skills/dr-cli/SKILL.md (or %USERPROFILE%\.claude\skills\dr-cli\SKILL.md on Windows). Trigger-gated: only loaded when your prompt matches a relevant verb.
• Gemini CLI → ~/.gemini/skills/dr-cli/SKILL.md plus a one-line @import appended to ~/.gemini/GEMINI.md between <!-- dr-cli:begin --> / <!-- dr-cli:end --> markers. Always-on (Gemini CLI doesn't have trigger gating).

Installed your assistant after dr-cli? Re-run dr skill install ~ once. The installer skips any assistant whose dotdir doesn't exist — re-running picks up newly present ones. Re-runs with the same skill bytes are no-ops.

Per-session usage

Each time you want to do dr-cli work, create a fresh working folder for that session and launch your assistant from inside it. The folder gives the assistant a scratch space for any files it produces (exports, snapshots, payloads), without polluting your home directory.

Claude Code

Windows (PowerShell):

mkdir $env:USERPROFILE\dr-work
cd $env:USERPROFILE\dr-work
claude

macOS / Linux:

mkdir -p ~/dr-work
cd ~/dr-work
claude

Gemini CLI

Windows (PowerShell):

mkdir $env:USERPROFILE\dr-work
cd $env:USERPROFILE\dr-work
gemini

macOS / Linux:

mkdir -p ~/dr-work
cd ~/dr-work
gemini

Verify the skill is loaded inside a Gemini session by typing /memory show — you should see a section sourced from ~/.gemini/skills/dr-cli/SKILL.md in the concatenated context. Use /memory reload if you re-ran dr skill install ~ mid-session.

Per-project setup — Gemini CLI & Codex CLI

For assistants that read context from the current folder (Codex CLI) or that benefit from a project-local override (Gemini CLI), run dr skill init-project inside the working folder. This is in addition to — not a replacement for — the global install: Claude Code keeps its trigger-gated global skill (no project-local copy needed).

Windows (PowerShell):

mkdir $env:USERPROFILE\dr-work
cd $env:USERPROFILE\dr-work
dr skill init-project
codex   # or: gemini

macOS / Linux:

mkdir -p ~/dr-work
cd ~/dr-work
dr skill init-project
codex   # or: gemini

dr skill init-project [dir] writes three files under the target directory (defaulting to the current folder):

• .dr-cli/SKILL.md — canonical local copy of the embedded skill markdown.
• GEMINI.md — picked up by Gemini CLI's hierarchical context loader. Contains a one-line @<abs path>/.dr-cli/SKILL.md import between <!-- dr-cli:begin --> / <!-- dr-cli:end --> markers.
• AGENTS.md — picked up by Codex CLI from the working directory. Codex doesn't support @import, so the full skill text is inlined verbatim between the same markers.

All three files are idempotent — re-running dr skill init-project after a dr-cli upgrade refreshes the block in place without touching any user content outside the markers. Pass --force if you've hand-edited .dr-cli/SKILL.md and want to overwrite it with the bundled version. CLAUDE.md is intentionally not created — Claude Code is wired globally by Step 3 and uses trigger gating, so a project-local copy would be redundant.

Try a prompt

Inside either assistant, the dr-cli skill is already loaded from your home directory — try one of:

• "Log me into DEV and show who I am"
• "List templates on US for organization 42"
• "Show LUT documents with unmapped items on DEV"
• "Calculate document 13655 for April 2026"

The assistant reads the skill, picks the right dr command, runs it, and presents the result. For destructive operations (delete / update) the skill instructs the assistant to confirm with you in chat before executing.

Update or remove

Update to the latest published version any time — same command as install:

npm install -g @datarails-ai/dr-cli --registry https://datarails.jfrog.io/artifactory/api/npm/dr-cli-virtual

Uninstall:

npm uninstall -g @datarails-ai/dr-cli