Skip to content

Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.

chore(readme): make the downloads badge live (#1165)

eneskirca91bafaba76e9
diff --git a/.github/workflows/download-badge.yml b/.github/workflows/download-badge.yml
new file mode 100644
index 000000000..d697ddb23
--- /dev/null
+++ b/.github/workflows/download-badge.yml
@@ -0,0 +1,61 @@
+name: Download badge
+
+# Keeps the README's downloads badge live. Counts INSTALLER downloads only (.dmg + .AppImage + .deb + .rpm + .exe
+# across every release): shields' own github/downloads/…/total reads ~14× higher, because
+# electron-updater's traffic (latest-*.yml polls, mac .zip deltas, blockmaps) counts as downloads.
+#
+# The result is a shields "endpoint" JSON on the orphan `badges` branch, force-pushed as a single
+# commit, so the history never grows. It lives off main on purpose: main is protected by required
+# checks, which a bot commit every few hours could never pass.
+on:
+ release:
+ types: [published]
+ schedule:
+ - cron: '23 */6 * * *'
+ workflow_dispatch:
+
+permissions:
+ contents: write
+
+concurrency:
+ group: download-badge
+ cancel-in-progress: false
+
+jobs:
+ update:
+ runs-on: ubuntu-latest
+ env:
+ GH_TOKEN: ${{ github.token }}
+ REPO: ${{ github.repository }}
+ steps:
+ - name: Count installer downloads
+ id: count
+ run: |
+ set -euo pipefail
+ total=$(gh api --paginate "repos/$REPO/releases" --jq \
+ '[.[].assets[] | select(.name|test("\\.(dmg|AppImage|deb|rpm|exe)$")) | .download_count] | add // 0' \
+ | awk '{ s += $1 } END { print s + 0 }')
+ # A failed or empty read must never publish "0" over a real number.
+ if [ "$total" -le 0 ]; then echo "count came back $total; refusing to publish" >&2; exit 1; fi
+ label=$(awk -v n="$total" 'BEGIN {
+ if (n >= 1000000) printf "%.1fM", n / 1000000
+ else if (n >= 1000) printf "%.1fk", n / 1000
+ else printf "%d", n }' | sed 's/\.0\([kM]\)$/\1/')
+ echo "total=$total label=$label"
+ echo "label=$label" >> "$GITHUB_OUTPUT"
+
+ - name: Publish to the badges branch
+ env:
+ LABEL: ${{ steps.count.outputs.label }}
+ run: |
+ set -euo pipefail
+ json=$(jq -cn --arg m "$LABEL" '{schemaVersion: 1, label: "downloads", message: $m, color: "brightgreen"}')
+ current=$(gh api "repos/$REPO/contents/downloads.json?ref=badges" --jq .content 2>/dev/null | base64 -d 2>/dev/null || true)
+ if [ "$current" = "$json" ]; then echo "unchanged ($LABEL)"; exit 0; fi
+ mkdir badges && cd badges
+ git init -q -b badges
+ printf '%s\n' "$json" > downloads.json
+ git add downloads.json
+ git -c user.name='github-actions[bot]' -c user.email='41898282+github-actions[bot]@users.noreply.github.com' \
+ commit -q -m "downloads: $LABEL"
+ git push -q --force "https://x-access-token:${GH_TOKEN}@github.com/${REPO}.git" badges
diff --git a/README.md b/README.md
index 0fc43bf06..566d14932 100644
--- a/README.md
+++ b/README.md
@@ -16,12 +16,11 @@ hidden tabs.
[![License](https://img.shields.io/badge/license-BUSL--1.1-blue)](./LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/eneskirca/nodeterm?style=flat)](https://github.com/eneskirca/nodeterm/stargazers)
[![Latest release](https://img.shields.io/github/v/release/eneskirca/nodeterm?include_prereleases&sort=semver)](https://github.com/eneskirca/nodeterm/releases)
-<!-- Installer downloads: .dmg + .AppImage + .deb + .rpm + Setup .exe across every release, hand-written on purpose.
- shields' github/downloads/…/total reads ~12× higher because electron-updater's own traffic
- (latest-*.yml polls, mac .zip deltas, blockmaps) is counted as downloads there. Recount with:
- gh api --paginate repos/eneskirca/nodeterm/releases --jq \
- '[.[].assets[] | select(.name|test("\\.(dmg|AppImage|deb|rpm|exe)$")) | .download_count] | add' -->
-[![Downloads](https://img.shields.io/badge/downloads-1.2k-brightgreen)](https://github.com/eneskirca/nodeterm/releases)
+<!-- Installer downloads only (.dmg + .AppImage + .deb + .rpm + .exe across every release), kept live by
+ .github/workflows/download-badge.yml, which writes a shields endpoint JSON to the `badges` branch.
+ shields' github/downloads/…/total reads ~14× higher because electron-updater's own traffic
+ (latest-*.yml polls, mac .zip deltas, blockmaps) is counted as downloads there. -->
+[![Downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Feneskirca%2Fnodeterm%2Fbadges%2Fdownloads.json)](https://github.com/eneskirca/nodeterm/releases)
<a href="https://trendshift.io/repositories/103825?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-103825" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/103825" alt="eneskirca%2Fnodeterm | Trendshift" width="250" height="55"/></a>