D›devcanon

Documentation / Installation

Install Devcanon on any operating system

Complete CLI and desktop installation instructions for macOS, Windows, and Linux.

Choose the installation path that fits how you work. The CLI and desktop app operate on the same local handbook.

Before you begin

  • Node.js 20 or newer for CLI installations and desktop updates.
  • A terminal with permission to install packages.
  • An existing repository, or an empty folder you want to initialize.

macOS

Terminal installation

Install Node.js with Homebrew if needed, install Devcanon globally, then initialize your repository.

Desktop application

Open the macOS release archive, download the latest DMG, open it, and move Devcanon Studio to Applications. If macOS blocks an unsigned preview, verify the release source before using Privacy & Security → Open Anyway.

Windows

PowerShell installation

Install the current Node.js LTS release, reopen PowerShell, then run:

Desktop application

Choose an MSI or EXE from the Windows release archive, verify its release notes, run the installer, then launch Devcanon Studio from the Start menu.

Linux

Terminal installation

Use your distribution’s Node.js 20+ package or a version manager, then install and initialize:

Desktop application

Choose an AppImage, DEB, or RPM from the Linux release archive. For an AppImage:

Without a global install

All operating systems can run Devcanon once through npx:

Verify the installation

Expected result: the repository contains .ai/AGENTS.md, the root discovery file, and all required standards. Devcanon reports preserved files rather than silently replacing them.