Set up your project¶

Set up N45 in any project where you want to use it.

Prerequisites¶

Node.js 22 or newer — needed to run npx n45-ai
Git installed on your machine
N45.AI account with an active license and logged in (npx n45-ai login)
One of the supported tools: Claude Code, Cursor, or Codex
A project initialized as a git repository (run git init first if needed)

Run the command¶

From the root of your project:

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

The CLI asks which IDE you use and sets up the project accordingly.

What gets created¶

your-project/
├── .n45/
│   └── (configuration files)
├── CLAUDE.md          # if Claude Code is installed
├── AGENTS.md          # if Codex is installed
├── .cursor/           # if Cursor is installed
└── .codex/            # if Codex is installed

Item	Purpose
`~/.n45/bin/`	N45 binary cache in your home — downloaded on first use, shared across projects
`.n45/` config	Settings for this project (organization, license, language)
`CLAUDE.md`	Instruction block Claude Code reads on every session
`AGENTS.md`	Equivalent for Codex
`.cursor/rules/`	Equivalent for Cursor
`.codex/`	Codex skills and permissions

What if I already have a CLAUDE.md?

N45 injects its block between  and  markers. Your existing content is preserved.

Verify the setup¶

Open your IDE and type / in the chat. You should see four new slash commands:

/n45
/n45-feat
/n45-fix
/n45-status

If they appear, you're ready. See Your first /n45.

Upgrade¶

To upgrade N45 in a project that already has it set up:

npx n45-ai upgrade

This migrates the project's .n45/ to the new version and refreshes the IDE configuration files. To update only the binary, use npx n45-ai update.

Start a new chat session

After upgrading, open a new chat in your AI assistant. Sessions that were already open keep using the previous version's skills.