gaztec 1.0.2 → 1.1.0

package/.github/workflows/release.yml

@@ -0,0 +1,48 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release-please:
+    name: Create Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+      id-token: write
+
+    steps:
+      - name: Run release-please
+        id: release
+        uses: googleapis/release-please-action@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          config-file: release-please-config.json
+
+      - name: Checkout
+        if: ${{ steps.release.outputs.release_created }}
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        if: ${{ steps.release.outputs.release_created }}
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        if: ${{ steps.release.outputs.release_created }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: "pnpm"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install dependencies
+        if: ${{ steps.release.outputs.release_created }}
+        run: pnpm install --frozen-lockfile
+
+      - name: Publish to npm
+        if: ${{ steps.release.outputs.release_created }}
+        run: pnpm publish

package/.github/workflows/test.yml

@@ -10,7 +10,7 @@ jobs:
       - uses: pnpm/action-setup@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 24
           cache: "pnpm"
 
       - name: Install dependencies

package/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.1.0"
+}

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## [1.1.0](https://github.com/nemi-fi/gaztec/compare/v1.0.3...v1.1.0) (2026-03-04)
+
+
+### Features
+
+* Add support for nargo command in gaztec ([5d8ec8d](https://github.com/nemi-fi/gaztec/commit/5d8ec8dfac7c5108dbecd33754d3f703d4a514b7))
+* Fallback to latest ([7fd4ec7](https://github.com/nemi-fi/gaztec/commit/7fd4ec7eab450465d263d0083705b48fdffbe67c))
+* Show gaztec version ([6aff490](https://github.com/nemi-fi/gaztec/commit/6aff4909800b966ac526f015902757c993d28f42))
+* Support aztec v4 dockerless cli ([#2](https://github.com/nemi-fi/gaztec/issues/2)) ([6589e7d](https://github.com/nemi-fi/gaztec/commit/6589e7df67500ddfa53fd2a77a32865d81ded476))
+
+
+### Bug Fixes
+
+* Add NARGO path to gaztec-install script ([b7e0dad](https://github.com/nemi-fi/gaztec/commit/b7e0dade2339536089b186bfb9be7cb905907435))
+* Bb path ([5ba1cd1](https://github.com/nemi-fi/gaztec/commit/5ba1cd120511967305dd9c0fd6262b110cc26d30))
+* Correct filename from .gaztecrc to .aztecrc in README.md ([a8819bb](https://github.com/nemi-fi/gaztec/commit/a8819bb4bffa0901a9c7f27fcacde475fa135fa1))
+* Fetch the latest version from github ([70d53c8](https://github.com/nemi-fi/gaztec/commit/70d53c8c23736243b12e41bd6943d5780c467f2f))
+* Fix installation ([77643a8](https://github.com/nemi-fi/gaztec/commit/77643a89816a396f9dd4b8cbe8b5fc6a516d8a74))
+* Handle npm prefix in CI environments ([a0e7ef7](https://github.com/nemi-fi/gaztec/commit/a0e7ef782f55353643fd8d17e951e835d49e8afe))
+* Update gaztec-install to set AZTEC_VERSION and modify GITHUB_PATH for CI ([1c7925d](https://github.com/nemi-fi/gaztec/commit/1c7925d57a6909e547624caa762905287a8db5ef))
+
+## [1.0.3] - 2025-03-04
+
+### Added
+
+- Support dockerless `aztec` installation

package/CONTRIBUTING.md

@@ -0,0 +1,10 @@
+# Contributing
+
+## Releasing
+
+Releases are automated with [release-please](https://github.com/googleapis/release-please). Use [Conventional Commits](https://www.conventionalcommits.org/) in your PRs (`feat:`, `fix:`, etc.). When a Release PR is merged, it will:
+
+1. Create a GitHub release and tag
+2. Publish to npm
+
+**Required secret:** Add `NPM_TOKEN` (npm automation token) to your repo secrets for publishing. Create one at npmjs.com → Account → Access Tokens.

package/README.md

@@ -1,30 +1,70 @@
 # Aztec version manager
 
-Manage your `aztec` versions without hussle. Automatically switch between versions in projects by creating a `.gaztecrc` file.
+Manage your `aztec` versions without hassle. Automatically switch between versions in projects by creating a `.aztecrc` file.
 
-## Installation
+## Why gaztec?
+
+- **No installation** — just run `npx gaztec` and go. No global install, no `npm i` required
+- **Automatic version switching** — drop a `.aztecrc` in your project and gaztec picks the right version
+- **No `aztec-up` needed** — versions are fetched on demand when you run a command
+- **Simple** — `npx gaztec <command>` replaces `aztec <command>` everywhere
+
+## Quick start
 
 ```sh
-npm i -g gaztec
+# create a file that defines the version of Aztec for your project
+echo "4.0.0-devnet.2-patch.2" > .aztecrc
+
+# use gaztec where you would use aztec (no install needed)
+npx gaztec --version
+#> 4.0.0-devnet.2-patch.2
 ```
 
-You can also install it locally and use it in your project:
+## `gaztec nargo`
+
+`gaztec nargo` exposes the pinned version of `nargo` that is compatible with the installed version of Aztec. Useful if you don't want to manage the version of `nargo` yourself.
 
 ```sh
-npm i gaztec -D
+# runs `nargo check` with the pinned version of `nargo`
+npx gaztec nargo check
 ```
 
-**WARNING**: if you use `pnpm` or `yarn`, you must use `npx gaztec` instead of `pnpm gaztec` or `yarn gaztec`.
+## Installation (optional)
 
-## Use in your project
+You can install gaztec globally or as a dev dependency (to pin the version) if you prefer:
 
 ```sh
-# create a file that defines the version of Aztec for your project
-echo "4.0.0-devnet.2-patch.2" > .gaztecrc
+npm i -g gaztec
+# or
+npm i gaztec -D
+```
 
-# use `gaztec` where you would use `aztec`
-gaztec --version
-#> 4.0.0-devnet.2-patch.2
+**Note**: with `pnpm` or `yarn`, use `npx gaztec` instead of `pnpm gaztec` or `yarn gaztec`.
+
+## CI
+
+Commit a `.aztecrc` file to your repo and use `npx gaztec` in your workflow. No setup step needed:
+
+```yaml
+name: Test
+
+on: [push]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      - name: Compile Aztec contracts
+        run: npx gaztec compile
+
+      - name: Start Aztec Local Network
+        run: npx gaztec start --local-network
 ```
 
 ## Compatibility with `aztec`

package/gaztec

@@ -3,4 +3,10 @@ set -euo pipefail
 
 source "$(dirname -- "${BASH_SOURCE[0]}")/gaztec-install"
 
-$AZTEC $@
+# if the subcommand is "nargo", run nargo instead
+if [[ "$1" == "nargo" ]]; then
+  shift
+  $NARGO $@
+else
+  $AZTEC $@
+fi

package/gaztec-install

@@ -51,6 +51,8 @@ if ! $AZTEC_UP list | grep $AZTEC_VERSION; then
   $AZTEC_UP install $AZTEC_VERSION
 fi
 
+$AZTEC_UP use $AZTEC_VERSION
+
 # needed due to a bug. Without this line, it tries to use bb from ~/.bb
 export BB="$AZTEC_PATH/versions/$AZTEC_VERSION/node_modules/.bin/bb"
 # needed due to a bug. Without this line, it tries to use nargo from ~/.nargo
@@ -61,4 +63,10 @@ if [[ -n "${CI:-}" ]] && command -v npm >/dev/null 2>&1; then
   npm config delete prefix
 fi
 
+# on github CI (GITHUB_PATH exists), add the aztec path to the path
+if [[ -n "${GITHUB_PATH:-}" ]]; then
+  echo "$AZTEC_PATH/versions/$AZTEC_VERSION/bin" >> $GITHUB_PATH
+  echo "$AZTEC_PATH/versions/$AZTEC_VERSION/node_modules/.bin" >> $GITHUB_PATH
+fi
+
 AZTEC="$AZTEC_PATH/versions/$AZTEC_VERSION/node_modules/.bin/aztec"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gaztec",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "type": "module",
   "description": "Aztec version manager",
   "repository": {

package/release-please-config.json

@@ -0,0 +1,14 @@
+{
+  "release-type": "simple",
+  "bump-minor-pre-major": true,
+  "bump-patch-for-minor-pre-major": true,
+  "pull-request-title-pattern": "chore: Release ${version}",
+  "group-pull-request-title-pattern": "chore: Release ${version}",
+  "packages": {
+    ".": {
+      "release-type": "node",
+      "include-component-in-tag": false
+    }
+  },
+  "plugins": ["sentence-case"]
+}

package/test/test.sh

@@ -3,4 +3,6 @@ set -euo pipefail
 
 source $(dirname -- "${BASH_SOURCE[0]}")/../gaztec --version
 
+source $(dirname -- "${BASH_SOURCE[0]}")/../gaztec nargo --version
+
 echo "Test passed"