How to Install Froid

Use npx maxwellai-froid install to install Froid in a project, connect it to your AI coding tool, and update it later.

When to Use This

• Install Froid in a new or existing project.
• Connect Froid skills to a supported AI coding tool.
• Update an existing Froid installation.
• Add or remove modules, change tools, or reconfigure an installation.

Prerequisites

• Node.js 20.12 or later is required to run the installer.
• A supported AI coding tool is required to use the installed skills. The installer can show the current list with npx maxwellai-froid install --list-tools.
• uv is required by skills that render or run Python through uv, including froid-build and froid-build-auto. If uv is missing, the installer warns you but still completes the installation.
• Git is required only when you install external modules or custom modules from Git.

Install and verify Froid

1. Open the target project

In a terminal, go to the project where you want to install Froid. The installer uses the current directory unless you choose a different destination.

2. Run the installer

npx maxwellai-froid install

Follow the prompts. The choices can change as modules and tool integrations change, but the installer guides you through the available modules, configuration, and supported AI coding tools.

If the installer reports an error or warning, follow the action it gives you. A missing-uv warning does not stop the installation, but skills that require uv will not work until you install it.

3. Check the success summary

When the installation finishes, the installer displays FROID is ready to use! and the path where it installed Froid. It also reports any warnings that still need attention.

4. Verify the tool integration

Open your selected AI coding tool from the project directory and invoke the froid-help skill. Ask it what to do next. If the tool recognizes and runs the skill, the integration is ready.

Update or reconfigure Froid

1. Rerun the installer

From the project that contains the _maxwellai-froid directory, run:

npx maxwellai-froid install

2. Choose the detected path

The installer detects the existing installation and offers the update or modification paths that apply to it. Choose an update to refresh the existing setup, or choose modification when you need to change modules, tools, or configuration. Follow any additional prompts the installer displays.

3. Verify the updated integration

Review the success summary, reopen your AI coding tool if needed, and invoke froid-help again.

Install the prerelease

To install prerelease core and Froid and apply prerelease selection to external modules chosen in that run, use:

npx maxwellai-froid@next install

To update a prerelease installation, rerun the same command. Prerelease builds change more frequently and can include unfinished changes, so use the stable command for ordinary project work.

Headless CI installs

For a typical fresh headless install of Froid configured for Claude Code, run:

npx maxwellai-froid install --yes --modules froid --tools claude-code

Use npx maxwellai-froid install --help to see the current automation flags and npx maxwellai-froid install --list-tools to find valid tool IDs. If your automation uses @next or an explicit package version, use that same tag or version when checking the help and running the installer.

What You Get

Froid’s skills are installed in the skill directories used by each AI tool you selected. The project’s _maxwellai-froid directory contains shared configuration and supporting scripts used by those skills. When installation finishes, the installer reports the configured tools and any warnings that still need attention.