Setup
Install Project and get a local project ready.
Choose The Installation Source
| Source | Install or update path |
|---|---|
| Managed macOS arm64 | Use the pinned installer generated from Project Space Machines; later run project self-update |
| Managed Linux x64 or WSL | Install the signed machine-tools bundle from the approved GitHub release; later run project self-update |
| Homebrew | Use Homebrew for both installation and updates |
| Native Windows | Run the approved per-user installer; self-update verifies and points to the next installer |
| Source checkout | Pull and rebuild from source; the updater never overwrites development binaries |
Managed releases install the Project CLI and connector as one matching pair. They preserve machine identity and credentials when upgraded.
Homebrew
brew tap DotNaos/project-space https://github.com/DotNaos/project-space
brew install --HEAD DotNaos/project-space/projectUpdate to the newest version:
brew update
brew reinstall --HEAD DotNaos/project-space/projectproject self-update detects Homebrew and leaves its files untouched.
Managed Linux And WSL
Download the versioned Linux x64 machine-tools archive and its checksum from the approved Project Space release. Verify the checksum, extract the archive, and run its install.sh as your normal user. Do not run the installer as root.
After the first managed installation:
project self-update --check
project self-updateNative Windows
Run the approved project-space-machine-tools-windows-x64-setup.exe installer as your normal user. Native Windows checks the signed release with project self-update --check, then reports the exact verified installer URL instead of replacing the running project.exe.
See the repository guides for the full Linux/WSL installation, Windows installation, and connector lifecycle.
First Project
project create my-project
cd my-projectFor an existing directory:
project initContinue with the generated CLI reference or the focused self-update guide.