Installation

Installing PolyForge is one clone and one command. The initializer is idempotent — running it twice is safe.

Prerequisites

Requirement	Why	Needed for
git	Clone the workspace and restore your content	Everything
A shell profile	The commands are registered into it	Everything
gh (GitHub CLI), logged in	Creating repos on your behalf	publish, forge new

mise itself is not a prerequisite — the initializer installs it if it is missing.

Install

Windows (PowerShell)

git clone git@github.com:rizaldevv/polyforge.git
cd polyforge
.\polyforge.ps1 activate

Linux / macOS / WSL

git clone git@github.com:rizaldevv/polyforge.git
cd polyforge
./polyforge.sh activate

Then open a new shell. The polyforge, learn and forge commands are now available.

Open a new shell

Activation writes to your shell profile ($PROFILE on Windows, ~/.bashrc or ~/.zshrc on POSIX). The current session will not see the commands until it is restarted or the profile is re-sourced.

Verify

1. Confirm the commands resolve:

   polyforge help

2. Run the health check:

   polyforge doctor

3. See the declared toolchain without installing anything:

   polyforge status

Nothing has been downloaded yet. That is deliberate — see explicit installs.

Install the toolchain

When you are ready:

polyforge install

This installs everything declared across .config/mise/conf.d/ and any mise.toml in scope. It is the only command that pulls tools.

Next

• First run — what activation did, in detail
• Your first project — scaffold and publish something