Getting Started

ulis compiles one canonical config tree into native configuration for Claude Code, Codex, Cursor, OpenCode, and ForgeCode.

Install

npm i -g @nejcm/ulis

or

bun add -g @nejcm/ulis

Requires Node 20+.

Project mode quick start

Use project mode when you want configuration that lives with a single repository.

cd my-project
ulis init

This creates .ulis/ in the current repository with scaffolded files and folders.

After editing .ulis/:

ulis install --yes

This builds generated output and installs into local tool folders like ./.claude/, ./.cursor/, ./.codex/, ./.opencode/, and ./.forge/ (plus ./.mcp.json).

Next reads

• Project vs Global Mode
• Source Layout
• CLI Reference