hostwithquantum · till · Mar 31, 2026 · Mar 28, 2026 · Mar 28, 2026 · Mar 28, 2026
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
@@ -8,3 +8,5 @@ updates:
       action-deps:
         patterns:
           - "*"
+    cooldown:
+      default-days: 7
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -6,8 +6,41 @@ on:
   pull_request:
     branches: [main]
 
+permissions: {}
+
 jobs:
   test:
+    permissions:
+      security-events: write
+      contents: read
+      actions: read
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - uses: zizmorcore/zizmor-action@71321a20a9ded102f6e9ce5718a2fcec2c4f70d8 # v0.5.2
+
+  version:
+    permissions:
+      contents: read
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - uses: ./
+        with:
+          version: 3.0.0-pre.1
+
+  e2e:
+    needs:
+      - test
+      - version
+    permissions:
+      contents: read
     strategy:
       fail-fast: false
       matrix:
@@ -28,12 +61,14 @@ jobs:
     runs-on: ${{ matrix.os }}
     name: ${{ matrix.name }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
 
       - uses: ./
         with:
-          username: "placeholder"
-          password: "placeholder"
+          api-key: "placeholder"
+          enable-cache: "false"
 
       - name: Show version
         run: quantum-cli -v

diff --git a/.github/zizmor.yml b/.github/zizmor.yml
@@ -0,0 +1,5 @@
+rules:
+  github-env:
+    ignore:
+      - action.yml:111:5
+      - action.yml:135:5
diff --git a/README.md b/README.md
@@ -20,41 +20,28 @@ A GitHub Action to install and configure [`quantum-cli`](https://cli.planetary-q
 
 ## Inputs
 
-You must provide **either** `api-key` **or** both `username` and `password`. You cannot use both methods together.
+You should provide an `api-key`, but it's optional.
 
-| Input | Description |
-|-------|-------------|
-| `api-key` | Your Quantum API key (recommended) |
-| `username` | Your Quantum username (**deprecated**, use `api-key` instead) |
-| `password` | Your Quantum password (**deprecated**, use `api-key` instead) |
+| Input | Description |  |
+|-------|-------------|----------|
+| `api-key` | Your Quantum API key | optional, adds the key to the environment |
+| `version` | The version | optional, defaults to latest |
+| `enable-cache` | Cache quantum-cli endpoint data between runs | optional, defaults to `true` |
 
 ## Usage
 
 For detailed documentation on the `quantum-cli`, please refer to our [docs](https://docs.planetary-quantum.com/).
 
-### Using API key (recommended)
+### Quickstart
 
 ```yaml
 steps:
-  - uses: hostwithquantum/setup-quantum-cli@v1
+  - uses: hostwithquantum/setup-quantum-cli@v2
     with:
       api-key: ${{ secrets.QUANTUM_API_KEY }}
   - run: quantum-cli auth status
 ```
 
-### Using username/password (deprecated)
-
-> **Warning**: username/password authentication is deprecated. Please migrate to `api-key`.
-
-```yaml
-steps:
-  - uses: hostwithquantum/setup-quantum-cli@v1
-    with:
-      username: ${{ secrets.QUANTUM_USERNAME }}
-      password: ${{ secrets.QUANTUM_PASSWORD }}
-  - run: quantum-cli auth status
-```
-
 ### Full workflow example
 
 ```yaml
@@ -69,7 +56,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
-      - uses: hostwithquantum/setup-quantum-cli@v1
+      - uses: hostwithquantum/setup-quantum-cli@v2
         with:
           api-key: ${{ secrets.QUANTUM_API_KEY }}
       - run: quantum-cli auth status
@@ -87,7 +74,7 @@ jobs:
     runs-on: windows-latest
     steps:
       - uses: actions/checkout@v6
-      - uses: hostwithquantum/setup-quantum-cli@v1
+      - uses: hostwithquantum/setup-quantum-cli@v2
         with:
           api-key: ${{ secrets.QUANTUM_API_KEY }}
       - run: quantum-cli.exe auth status
@@ -100,9 +87,12 @@ The action sets the following environment variables for subsequent steps:
 When using API key:
 - `QUANTUM_API_KEY` — your API key
 
-When using username/password (deprecated):
-- `QUANTUM_USER` — your username
-- `QUANTUM_PASSWORD` — your password
+## Dependencies
+
+- `bash`
+- `curl`
+- `sha256sum`
+- `actions/cache`
 
 ## License
 

diff --git a/action.yml b/action.yml
@@ -4,102 +4,133 @@ branding:
   icon: 'zap'
   color: 'red'
 inputs:
-  username:
-    required: false
-    description: Your Quantum username (required if not using api-key)
-  password:
-    required: false
-    description: Your Quantum password (required if not using api-key)
   api-key:
     required: false
     description: Your Quantum API key (alternative to username/password)
+  version:
+    required: false
+    description: Optional version to install
+  enable-cache:
+    required: false
+    default: 'true'
+    description: Enable caching of quantum-cli endpoint data between runs
+  download-url:
+    required: false
+    default: https://cli-v3.planetary-quantum.com
+    description: Optional download URL
 runs:
   using: "composite"
   steps:
-  - name: validate inputs
-    run: |
-      HAS_USERNAME="${{ inputs.username != '' }}"
-      HAS_PASSWORD="${{ inputs.password != '' }}"
-      HAS_API_KEY="${{ inputs.api-key != '' }}"
 
-      if [ "$HAS_API_KEY" = "true" ]; then
-        if [ "$HAS_USERNAME" = "true" ] || [ "$HAS_PASSWORD" = "true" ]; then
-          echo "::error title=Invalid inputs::Cannot use api-key together with username/password. Use either api-key OR username+password."
-          exit 1
-        fi
+  - name: resolve version
+    env:
+      DOWNLOAD_URL: ${{ inputs.download-url }}
+      INPUTS_VERSION: ${{ inputs.version }}
+    id: get_version
+    run: |
+      if [ -n "${INPUTS_VERSION}" ]; then
+        echo "cli-version=${INPUTS_VERSION}" >> $GITHUB_OUTPUT
       else
-        if [ "$HAS_USERNAME" != "true" ] || [ "$HAS_PASSWORD" != "true" ]; then
-          echo "::error title=Missing credentials::Must provide either api-key OR both username and password."
-          exit 1
-        fi
+        LATEST=$(curl -s "${DOWNLOAD_URL}/latest.txt")
+        echo "cli-version=$LATEST" >> $GITHUB_OUTPUT
       fi
     shell: bash
-  - name: deprecation warning (username/password)
-    if: inputs.api-key == ''
-    run: echo "::warning title=Deprecated::username/password authentication is deprecated. Please migrate to api-key."
+
+  - run: echo "Installing ${STEPS_GET_VERSION_OUTPUTS_CLI_VERSION}" >> $GITHUB_STEP_SUMMARY
     shell: bash
-  - name: install quantum-cli (Linux)
-    if: runner.os == 'Linux'
+    env:
+      STEPS_GET_VERSION_OUTPUTS_CLI_VERSION: ${{ steps.get_version.outputs.cli-version }}
+
+  - name: resolve binary
+    env:
+      RUNNER_OS: ${{ runner.os }}
+    id: cli
     run: |
       if [ "${{ runner.arch }}" = "ARM64" ]; then
         ARCH="arm64"
       else
         ARCH="amd64"
       fi
-      curl \
-        -H 'Cache-Control: no-cache' \
-        "https://cli.planetary-quantum.com/quantum-cli-linux-${ARCH}?v=$RANDOM" \
-        -o ${{ github.action_path }}/quantum-cli \
-        && chmod +x ${{ github.action_path }}/quantum-cli
+      case "${RUNNER_OS}" in
+        Linux)  echo "bin=quantum-cli-linux-${ARCH}" >> $GITHUB_OUTPUT ;;
+        macOS)  echo "bin=quantum-cli-darwin-${ARCH}" >> $GITHUB_OUTPUT ;;
+        Windows) echo "bin=quantum-cli-windows-${ARCH}.exe" >> $GITHUB_OUTPUT ;;
+      esac
     shell: bash
-  - name: install quantum-cli (macOS)
-    if: runner.os == 'macOS'
+
+  - name: download checksums
+    env:
+      DOWNLOAD_URL: ${{ inputs.download-url }}
+      CLI_VERSION: ${{ steps.get_version.outputs.cli-version }}
+      ACTION_PATH: ${{ github.action_path }}
     run: |
-      if [ "${{ runner.arch }}" = "ARM64" ]; then
-        ARCH="arm64"
-      else
-        ARCH="amd64"
-      fi
-      curl \
-        -H 'Cache-Control: no-cache' \
-        "https://cli.planetary-quantum.com/quantum-cli-darwin-${ARCH}?v=$RANDOM" \
-        -o ${{ github.action_path }}/quantum-cli \
-        && chmod +x ${{ github.action_path }}/quantum-cli
+      curl -s "${DOWNLOAD_URL}/${CLI_VERSION}/checksums.txt" \
+        -o "${ACTION_PATH}/checksums.txt"
     shell: bash
-  - name: install quantum-cli (Windows)
-    if: runner.os == 'Windows'
+
+  - name: download quantum-cli
+    env:
+      DOWNLOAD_URL: ${{ inputs.download-url }}
+      CLI_VERSION: ${{ steps.get_version.outputs.cli-version }}
+      CLI_BIN: ${{ steps.cli.outputs.bin }}
+      ACTION_PATH: ${{ github.action_path }}
     run: |
-      if ("${{ runner.arch }}" -eq "ARM64") {
-        $arch = "arm64"
-      } else {
-        $arch = "amd64"
-      }
-      $url = "https://cli.planetary-quantum.com/quantum-cli-windows-${arch}.exe?v=$(Get-Random)"
-      Invoke-WebRequest -Uri $url -OutFile "${{ github.action_path }}\quantum-cli.exe"
-    shell: pwsh
-  - name: add to PATH (Linux/macOS)
+      curl -s "${DOWNLOAD_URL}/${CLI_VERSION}/${CLI_BIN}" \
+        -o "${ACTION_PATH}/${CLI_BIN}"
+    shell: bash
+
+  - name: verify checksum
+    env:
+      CLI_BIN: ${{ steps.cli.outputs.bin }}
+      ACTION_PATH: ${{ github.action_path }}
+    run: |
+      cd "${ACTION_PATH}"
+      grep "${CLI_BIN}" checksums.txt | sha256sum -c -
+      echo "Checksum verified 🛡️" >> $GITHUB_STEP_SUMMARY
+    shell: bash
+
+  - name: install quantum-cli (Linux/macOS)
     if: runner.os != 'Windows'
-    run: echo "${{ github.action_path }}" >> $GITHUB_PATH
+    env:
+      CLI_BIN: ${{ steps.cli.outputs.bin }}
+      ACTION_PATH: ${{ github.action_path }}
+    run: install -m 755 "${ACTION_PATH}/${CLI_BIN}" "${ACTION_PATH}/quantum-cli"
     shell: bash
-  - name: add to PATH (Windows)
+
+  - name: install quantum-cli (Windows)
     if: runner.os == 'Windows'
-    run: echo "${{ github.action_path }}" | Out-File -FilePath $env:GITHUB_PATH -Append
-    shell: pwsh
+    env:
+      CLI_BIN: ${{ steps.cli.outputs.bin }}
+      ACTION_PATH: ${{ github.action_path }}
+    run: install -m 755 "${ACTION_PATH}/${CLI_BIN}" "${ACTION_PATH}/quantum-cli.exe"
+    shell: bash
+
+  - name: add to path
+    env:
+      ACTION_PATH: ${{ github.action_path }}
+    run: echo "${ACTION_PATH}" >> $GITHUB_PATH
+    shell: bash
+
   - name: verify installation (Linux/macOS)
     if: runner.os != 'Windows'
     run: quantum-cli -v
     shell: bash
+
   - name: verify installation (Windows)
     if: runner.os == 'Windows'
     run: quantum-cli.exe -v
     shell: pwsh
-  - name: set credentials (username/password)
-    if: inputs.api-key == ''
-    run: |
-      echo "QUANTUM_USER=${{ inputs.username }}" >> "$GITHUB_ENV"
-      echo "QUANTUM_PASSWORD=${{ inputs.password }}" >> "$GITHUB_ENV"
-    shell: bash
+
+  - name: quantum endpoint cache
+    if: inputs.enable-cache == 'true'
+    uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4
+    with:
+      path: ~/.cache/quantum
+      key: quantum-cache-${{ runner.os }}-${{ runner.arch }}
+
   - name: set credentials (api-key)
+    env:
+      API_KEY: ${{ inputs.api-key }}
     if: inputs.api-key != ''
-    run: echo "QUANTUM_API_KEY=${{ inputs.api-key }}" >> "$GITHUB_ENV"
+    run: echo "QUANTUM_API_KEY=${API_KEY}" >> "$GITHUB_ENV"
     shell: bash