NOAH DEV CLI

Docs

How it works

Noah is an intelligent project bootstrapper and AI workflow package manager. Start with bootstrap — or browse and install packages by hand when you prefer.

Intelligent Project Bootstrap

The recommended path for first-time users. Noah detects your stack, shows recommendations, then asks before installing — confirm to proceed, or skip and pick packages yourself.

  1. 01

    Detect stack

    Scans the repo for frameworks and tooling (Laravel, React, Next, NestJS, Docker, CI, and more).

  2. 02

    Analyse project

    Scores architecture, security, documentation, and testing — then surfaces what’s missing.

  3. 03

    Recommend & confirm

    Shows the best Skills, Rules, and Presets, then asks Install N recommended package(s)? — confirm, skip, or use -y to auto-accept.

  4. 04

    Install & configure

    On yes, installs into your IDE folder and writes noah.config.json + noah.lock. 

Clone Repository
       ↓
  noah bootstrap
       ↓
 Detect → Analyse → Recommend → Confirm → Install
       ↓
 Generate noah.config.json
       ↓
 Ready to Develop
$ npx noah-cursor bootstrap? Install 5 recommended package(s)? (Y/n)$ npx noah-cursor bootstrap -y$ npx noah-cursor bootstrap --target claude$ npx noah-cursor bootstrap --dry-run

Interactive home

Run noah / noah-cursor with no arguments in a TTY to open the home menu. First option is Bootstrap project, then browse Skills, Rules, Prompts, MCP, or Presets (only categories that exist in the registry).

Browse & install

Prefer picking packages yourself? Use interactive browse (Skills, Rules, Prompts, MCP, Presets) or install by name.

  1. 01

    Select IDE

    Defaults to Cursor. Or pass --ide / --target.

  2. 02

    Browse or name packages

    browse for the TUI, or install laravel-api / install laravel-enterprise.

  3. 03

    Confirm & install

    Assets copy into the IDE root. Official registry ships in the package.

↑↓ navigate Space select A toggle all Enter confirm Esc cancel

IDE folders

Same registry. Destination depends on what you pick (or pass with --ide / --target).

  • Cursor .cursor/ default
  • Windsurf .windsurf/
  • Claude Code .claude/
  • Continue .continue/
  • VS Code .vscode/
  • Cline .cline/
  • Gemini CLI .gemini/
  • Codex CLI .codex/
  • Roo Code .roo/
  • Aider .aider/

What lands in the project

After bootstrap or install (example for Cursor):

.cursor/
  skills/commit-push/
  rules/laravel-api/
  prompts/
  mcp/
  noah.json          # per-IDE install ledger
noah.config.json     # team workspace package list
noah.lock            # pinned versions

Workspace & lockfile

noah.config.json is the team workspace — a list of packages to keep in sync with noah sync. noah.lock pins installed versions after install/update/remove. Per-IDE metadata still lives in .cursor/noah.json (or the matching IDE root).

CLI demo

From a clone of this repo, run a non-interactive walkthrough of the main commands (search, analyze, bootstrap, install, workspace, multi-target, and more): 

$ npm run demo

Quick start

Requires Node.js 20+. Registry ships inside the package.

$ npx noah-cursor bootstrap$ npx noah-cursor$ npx noah-cursor browse$ npx noah-cursor install commit-push