n45-ai init¶

Set up N45 in the current project.

Synopsis¶

npx n45-ai init

Prerequisites¶

Node.js 22 or newer
Git installed on your machine
An active N45.AI license and a prior npx n45-ai login

Description¶

Asks which IDE assistants you use (Claude Code, Cursor, or Codex) and sets up the project:

Creates the .n45/ directory
IDE-specific configuration (.claude/, .cursor/, or .codex/)
Slash commands (/n45, /n45-feat, /n45-fix, /n45-status)

init does not download the binary — that happens on first use (login, status, or a slash command), or explicitly via install.

Must be run from the root of your project. Requires a prior npx n45-ai login — which itself requires an active N45.AI license.

Already set up with a different version?

If the project already has N45 skills and a .n45/ folder from a different version, init stops and asks you to run upgrade first. This guarantees the project's .n45/ is migrated before the skills are replaced — running new skills against an old .n45/ schema would corrupt it. Re-running init on the same version is safe (e.g. to add another IDE).

What it modifies¶

File / folder	Action
`.n45/`	Created
`.claude/`	Created (skills + settings)
`.cursor/`	Created (skills + cli.json + .cursorignore)
`.codex/`	Created (skills + permissions)

Your existing settings are preserved when N45 updates a shared file.

Examples¶

cd /path/to/your/project
npx n45-ai init