Skip to content

Set up

After logging in, set up N45 where you'll use it. N45 works in two modes, chosen at init:

  • Project — a single repository (an app, a microservice, a monorepo).
  • Workspace — several repositories, polyrepo (a separate frontend and api, for example).

Prerequisites

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

Run the command

From the folder where you'll use it (your repository's root, or the folder that groups the repositories):

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

init first asks what you're setting up — Project or Workspace. If the folder already has subfolders that are git repositories, N45 detects a Workspace automatically. It then asks which IDEs you use (Claude Code, Cursor, Codex) and installs the skills.

Project — what's created

your-project/
├── .n45/              # what N45 needs (config + docs)
├── 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/ The N45 binary cache in your home — downloaded on first use, shared across projects
.n45/ This project's config and documents
CLAUDE.md / AGENTS.md / .cursor/rules/ / .codex/ The instruction block your IDE reads every session

What if I already have a CLAUDE.md?

N45 injects its block between the <!-- n45:start --> and <!-- n45:end --> markers. Your existing content is preserved.

Workspace — what's created

A coordination .n45/ in the workspace folder (the workspace name is the folder name). At the end of init, N45 lists the git folders it found and offers to add them as members, all pre-selected — just confirm. Each member is prepared automatically (it gets its own .n45/ and skills).

You can add more members at any time:

npx n45-ai@latest workspace add ./frontend          # a local repository
npx n45-ai@latest workspace add git@github.com:acme/api.git   # clone from a URL

The full workspace flow is in Set up a Workspace.

Verify the setup

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

  • /n45 — the hub (resumes work or shows the state)
  • /n45-feat — build a feature
  • /n45-fix — investigate and fix a bug
  • /n45-status — see the state
  • /n45-next — advance execution
  • /n45-run — run the application

Prefix per tool

In Claude Code and Cursor the commands use /. In Codex they use $ (e.g. $n45).

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