# Installation Guide

## npm

Install the current stable release with `npm install --global forgevena@1.3.0`.

## Verified archive

Download `forgevena-1.3.0.tgz` and `RELEASE_SHA256SUMS` from the [latest release](https://github.com/rohitkumarnaidu/Forgevena/releases/latest), verify the checksum, install with `npm install --global ./forgevena-1.3.0.tgz`, then run `forgevena version` and `forgevena doctor`.

## Standalone executables

The `v1.3.0` release publishes `forgevena-win-x64.exe`, `forgevena-linux-x64`, and `forgevena-macos-x64`. Download the matching executable and `RELEASE_SHA256SUMS`, verify SHA-256 before execution, and grant execute permission on Linux or macOS. npm remains the supported arm64 installation path for this release.

## Homebrew

The maintained [Forgevena Homebrew tap](https://github.com/rohitkumarnaidu/homebrew-forgevena) installs the immutable `v1.3.0` native executable on Linux and Intel macOS:

```bash
brew install rohitkumarnaidu/forgevena/forgevena
forgevena version
forgevena doctor
```

To remove it later, run `brew uninstall forgevena`; optionally remove the Forgevena source from Homebrew as well. The formula is x64-only because the current native release assets are x64-only; use npm on arm64.

## Source checkout

Clone the repository, use Node.js 20.19+, run `npm test`, and execute `node ./bin/forgevena.js help`.

## Containers

Build `Dockerfile.cli`, run the image with `version`, and mount a disposable project directory for modifying commands.

## Package-channel status

| Channel | Available version | Status | Install or verification |
| --- | --- | --- | --- |
| npm | `1.3.0` | Published stable | `npm install --global forgevena@1.3.0` |
| Homebrew tap | `1.3.0` | Published | `brew install rohitkumarnaidu/forgevena/forgevena` |
| Winget | `1.2.3` | Published upstream after [PR 404506](https://github.com/microsoft/winget-pkgs/pull/404506) passed validation and moderation | Run `winget source update`, then `winget install --id RohitKumarNaidu.Forgevena --exact` |
| Chocolatey community | `1.2.3` | Validation and automated testing passed; human moderation remains pending | Do not treat the community package as generally available until the [package page](https://community.chocolatey.org/packages/forgevena/1.2.3) reports approval |

Homebrew, Winget, and Chocolatey bundles originate from immutable native release executables, but each external repository publishes on its own schedule. Winget currently trails the stable npm and Homebrew release. See the [Publishing Guide](../RELEASE_GUIDE.md) and [Compatibility Matrix](../COMPATIBILITY_MATRIX.md).