Release/v0.2.0

.github/CODEOWNERS

@@ -0,0 +1,2 @@
+* @AgoraIO/devrel
+

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -10,15 +10,15 @@ body:
         can reproduce and triage the issue quickly.
 
         - **Do not** include credentials, App Certificates, or session tokens
-          in any field. Run `agora doctor --json` redacted if needed.
+          in any field. Run `agora project doctor --json` redacted if needed.
         - For security issues, email <security@agora.io> instead.
 
   - type: input
     id: cli-version
     attributes:
       label: CLI version
       description: Output of `agora --version`
-      placeholder: "e.g. agora-cli-go 0.1.9 (commit abc1234, built 2026-04-30)"
+      placeholder: "e.g. agora-cli 0.2.0 (commit abc1234, built 2026-05-04)"
     validations:
       required: true
 
@@ -84,9 +84,9 @@ body:
   - type: textarea
     id: doctor
     attributes:
-      label: `agora doctor --json` output
+      label: `agora project doctor --json` output
       description: |
-        Optional but very helpful. Run `agora doctor --json` and paste the output here. Redact anything sensitive first.
+        Optional but very helpful. Run `agora project doctor --json` and paste the output here. Redact anything sensitive first.
       render: json
     validations:
       required: false

.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: gomod
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: npm
+    directory: /packaging/npm/agoraio-cli
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+

.github/workflows/ci.yml

@@ -61,11 +61,16 @@ jobs:
           # run `make docs-commands` locally and commit the result.
           go run ./cmd/gendocs -check
 
+      # Prebuilt golangci-lint binaries may be compiled with an older Go than
+      # go.mod; loading .golangci.yml then fails ("Go language version used to
+      # build golangci-lint is lower than the targeted Go version"). Building
+      # from source with setup-go matches the project's toolchain.
       - name: golangci-lint
         if: runner.os == 'Linux'
         uses: golangci/golangci-lint-action@v6
         with:
           version: v1.64.8
+          install-mode: goinstall
           args: --timeout=5m
 
       - name: Build CLI
@@ -83,6 +88,11 @@ jobs:
         shell: bash
         run: sh -n install.sh
 
+      - name: Smoke test installer messages
+        if: runner.os != 'Windows'
+        shell: bash
+        run: sh scripts/test-installer-messages.sh
+
       - name: Check PowerShell installer syntax
         if: runner.os == 'Windows'
         shell: pwsh

.github/workflows/govulncheck.yml

@@ -0,0 +1,35 @@
+name: govulncheck
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  schedule:
+    - cron: "17 9 * * 1"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  govulncheck:
+    name: Run govulncheck
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+          cache: true
+
+      - name: Install govulncheck
+        run: go install golang.org/x/vuln/cmd/govulncheck@latest
+
+      - name: Scan
+        run: govulncheck ./...
+

.github/workflows/pages.yml

@@ -0,0 +1,71 @@
+name: Publish CLI docs
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "cmd/gendocs/**"
+      - "internal/cli/**"
+      - "scripts/prepare-pages-site.py"
+      - ".github/workflows/pages.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build CLI docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+          cache: true
+
+      - name: Verify generated command reference
+        run: go run ./cmd/gendocs -check
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Build Pages site
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./docs
+          destination: ./_site
+
+      - name: Prepare human and agent docs
+        run: python3 scripts/prepare-pages-site.py --source docs --site _site --env-file docs/site.env
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./_site
+
+  deploy:
+    name: Deploy CLI docs
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

.github/workflows/release.yml

@@ -210,7 +210,7 @@ jobs:
 
           stage_platform() {
             local goos="$1" goarch="$2" npm_pkg="$3" bin_name="$4" archive_ext="$5"
-            local pkg_dir="packaging/npm/@agoraio/${npm_pkg}"
+            local pkg_dir="packaging/npm/${npm_pkg}"
             local archive="agora-cli-go_${tag}_${goos}_${goarch}.${archive_ext}"
 
             mkdir -p "${pkg_dir}/bin"
@@ -223,12 +223,12 @@ jobs:
             echo "  staged: ${pkg_dir}/bin/${bin_name}"
           }
 
-          stage_platform darwin  arm64 cli-darwin-arm64 agora     tar.gz
-          stage_platform darwin  amd64 cli-darwin-x64   agora     tar.gz
-          stage_platform linux   arm64 cli-linux-arm64  agora     tar.gz
-          stage_platform linux   amd64 cli-linux-x64    agora     tar.gz
-          stage_platform windows amd64 cli-win32-x64    agora.exe zip
-          stage_platform windows arm64 cli-win32-arm64  agora.exe zip
+          stage_platform darwin  arm64 agoraio-cli-darwin-arm64 agora     tar.gz
+          stage_platform darwin  amd64 agoraio-cli-darwin-x64   agora     tar.gz
+          stage_platform linux   arm64 agoraio-cli-linux-arm64  agora     tar.gz
+          stage_platform linux   amd64 agoraio-cli-linux-x64    agora     tar.gz
+          stage_platform windows amd64 agoraio-cli-win32-x64    agora.exe zip
+          stage_platform windows arm64 agoraio-cli-win32-arm64  agora.exe zip
 
       - name: Stamp version into all package.json files
         shell: bash
@@ -238,12 +238,12 @@ jobs:
           echo "Stamping version: $version"
 
           for pkg in \
-            packaging/npm/@agoraio/cli-darwin-arm64 \
-            packaging/npm/@agoraio/cli-darwin-x64 \
-            packaging/npm/@agoraio/cli-linux-arm64 \
-            packaging/npm/@agoraio/cli-linux-x64 \
-            packaging/npm/@agoraio/cli-win32-x64 \
-            packaging/npm/@agoraio/cli-win32-arm64; do
+            packaging/npm/agoraio-cli-darwin-arm64 \
+            packaging/npm/agoraio-cli-darwin-x64 \
+            packaging/npm/agoraio-cli-linux-arm64 \
+            packaging/npm/agoraio-cli-linux-x64 \
+            packaging/npm/agoraio-cli-win32-x64 \
+            packaging/npm/agoraio-cli-win32-arm64; do
             tmp=$(mktemp)
             jq --arg v "$version" '.version = $v' "${pkg}/package.json" > "$tmp"
             mv "$tmp" "${pkg}/package.json"
@@ -265,12 +265,12 @@ jobs:
         run: |
           set -euo pipefail
           for pkg in \
-            packaging/npm/@agoraio/cli-darwin-arm64 \
-            packaging/npm/@agoraio/cli-darwin-x64 \
-            packaging/npm/@agoraio/cli-linux-arm64 \
-            packaging/npm/@agoraio/cli-linux-x64 \
-            packaging/npm/@agoraio/cli-win32-x64 \
-            packaging/npm/@agoraio/cli-win32-arm64; do
+            packaging/npm/agoraio-cli-darwin-arm64 \
+            packaging/npm/agoraio-cli-darwin-x64 \
+            packaging/npm/agoraio-cli-linux-arm64 \
+            packaging/npm/agoraio-cli-linux-x64 \
+            packaging/npm/agoraio-cli-win32-x64 \
+            packaging/npm/agoraio-cli-win32-arm64; do
             echo "Publishing $pkg ${PUBLISH_ARGS}"
             # --provenance is honored by publishConfig.provenance; passing here for clarity.
             # When PUBLISH_ARGS contains --dry-run, no provenance attestation is created.

.gitignore

@@ -15,3 +15,6 @@ agora-cli-go
 # IDE and editor files
 .idea/
 .vscode/
+
+# Local Jekyll / Pages preview output (see `make docs-preview`)
+_site/