v0.0.5

What's New in v0.0.5

Fix: velocix upgrade points to canonical repo URL

The velocix upgrade command now queries millwrights/velocix (the current repo location) instead of the old learndevopsonline/velocix URL. The old URL still worked via GitHub's redirect, but the canonical URL is more reliable.

If you're on v0.0.4 or earlier, run velocix upgrade to pick up this fix.

Downloads

• velocix-darwin-amd64 — macOS Intel
• velocix-darwin-arm64 — macOS Apple Silicon
• velocix-linux-amd64 — Linux x86_64
• velocix-linux-arm64 — Linux ARM64

v0.0.4

What's New in v0.0.4

This release focuses on GitHub API rate limit relief, operational visibility, and self-upgrades.

Sync Mode: Auto vs Manual

You can now choose how Velocix polls GitHub:

• Auto (default) — polls every 60 seconds (bumped from 30s in this release to reduce API usage by 50%).
• Manual — Velocix never polls automatically. Use the Sync now button in the sidebar when you want fresh data.

Toggle is in the left sidebar. The setting persists in your config (sync_mode: auto|manual). The header indicator switches between "Live" and "Manual" so you always know which mode you're in.

When to use manual:

• You hit GitHub's 5,000 req/hour rate limit often
• You only need to check status occasionally
• You have many repos but watch them rarely

Rate Limit Visibility

No more hunting through server logs to find out why workflow runs aren't updating.

The header now shows a colored pill with your GitHub API usage:

• Green — plenty of capacity (API: 4823 / 5000)
• Yellow — less than 50% remaining
• Red — exceeded, with countdown to reset (API: Rate limit exceeded — resets in 23m 14s)

Hover for the exact reset timestamp. The display tracks the worst case across all configured orgs and updates after every poll.

velocix upgrade Command

Self-update Velocix without manually downloading binaries:

velocix upgrade

What it does:

1. Queries GitHub Releases for the latest version
2. If you're already on the latest, exits cleanly
3. Downloads the binary matching your OS and architecture
4. Verifies it runs (velocix --version)
5. If velocix serve is currently running:
   • Sends SIGTERM via the PID file written at ~/.velocix/velocix.pid
   • Waits for shutdown
   • Atomically replaces the binary
   • Restarts with the same arguments detached, with logs at ~/.velocix/velocix.log
6. If not running, just replaces the binary

Default Poll Interval Changed

Default poll_interval is now 60 seconds (was 30s). Existing configs with an explicit interval are unchanged. To adopt the new default, remove the line from ~/.velocix/config.yaml or update it explicitly.

API Additions

• GET /api/sync-mode — current sync mode
• POST /api/sync-mode {"mode":"auto|manual"} — change mode
• POST /api/sync — trigger an immediate sync for all orgs
• GET /api/rate-limit — per-org and worst-case rate limit info

Downloads

• velocix-darwin-amd64 — macOS Intel
• velocix-darwin-arm64 — macOS Apple Silicon
• velocix-linux-amd64 — Linux x86_64
• velocix-linux-arm64 — Linux ARM64

Upgrading from v0.0.3

velocix upgrade

Or download a binary above and replace your existing one.

v0.0.3

What's New in v0.0.3

GraphQL-Powered Repo Listing

• Switched from REST to GraphQL API for listing repositories
• 1 API call replaces 34+ paginated REST calls per org
• Dramatically reduces GitHub API usage, staying well within the 5,000 req/hour rate limit

Speed V Logo

• New branded logo in the web UI header — blue-to-green gradient V with motion lines

CLI Flow Improvements

• config init and config add now ask in the right order:
  1. GitHub URL (enterprise or default)
  2. Token (browser opens to the correct URL — github.com or your enterprise instance)
  3. Organization name
  4. Display name
• config remove --all / -a — wipe all orgs and reset config to defaults
• Fixed bug where removed orgs reappeared due to legacy config migration

Downloads

• velocix-darwin-amd64 — macOS Intel
• velocix-darwin-arm64 — macOS Apple Silicon
• velocix-linux-amd64 — Linux x86_64
• velocix-linux-arm64 — Linux ARM64

v0.0.2

What's New in v0.0.2

GitHub Enterprise Support

• Custom GitHub URLs: Configure a custom GitHub Enterprise Server URL per organization
• Organizations can now point to any GitHub Enterprise instance (e.g. https://github.example.com)
• API calls and web UI hyperlinks automatically use the configured enterprise URL
• Default remains https://github.com when no custom URL is set

CLI Improvements

• velocix config init now prompts for an optional GitHub Enterprise URL (Step 3)
• velocix config add prompts for custom GitHub URL when adding a new org
• velocix config show displays the configured URL for each organization

Build Improvements

• Added Linux AMD64 and ARM64 build targets
• All four platform binaries included in this release

Configuration

Add base_url to any org in your config to use GitHub Enterprise:

orgs:
  - name: enterprise
    organization: my-org
    github_token: ghp_xxx
    base_url: https://github.example.com

Downloads

• velocix-darwin-amd64 — macOS Intel
• velocix-darwin-arm64 — macOS Apple Silicon
• velocix-linux-amd64 — Linux x86_64
• velocix-linux-arm64 — Linux ARM64

Velocix v0.0.1

Velocix v0.0.1 — Centralized Pipeline Viewer

The first release of Velocix, a single-binary tool for monitoring GitHub Actions workflow runs across your entire organization in real-time.

Features

Web Dashboard

• GitHub Primer dark theme — matches the GitHub UI look and feel
• Real-time auto-refresh every 5 seconds with live indicator
• Left sidebar filters with multi-select checkboxes for status, repository, and workflow
• Organization dropdown — switch between multiple configured GitHub orgs instantly
• Full-text search across workflow names, repos, branches, and actors
• Active filter tags with one-click removal
• Hyperlinked everything — click any repo, branch, actor, or run to open it on GitHub
• Status tabs (All / Success / Failure / In Progress) with live counters
• SVG status icons — animated spinner for in-progress runs

Terminal UI (TUI)

• k9s-style interface built with Bubble Tea
• Vim keybindings — j/k to navigate, Enter to open run in browser
• Filter cycling — press 1/2/3 to cycle through repo/status/workflow filters
• Full-screen alternate screen with mouse support

Multi-Org Configuration

• velocix config init — interactive guided setup that opens browser for GitHub token creation
• velocix config add — add additional organizations
• velocix config remove / velocix config use — manage and switch orgs
• velocix config list / velocix config show — view all configured orgs
• Orgs can be switched from the CLI or directly from the web UI dropdown

Core

• Near real-time polling with configurable interval (default 30s)
• Concurrent fetching across all repos in an org (5 parallel workers)
• Local caching — per-org JSON cache files for instant startup
• Graceful shutdown with signal handling
• Environment variable support (GITHUB_TOKEN, VELOCIX_ORG)

Installation

Download the binary for your platform, extract, and run:

tar xzf velocix-0.0.1-<platform>.tar.gz
chmod +x velocix-<platform>
mv velocix-<platform> /usr/local/bin/velocix

Quick Start

velocix config init
velocix serve
velocix tui

Platforms

File	Platform
velocix-0.0.1-darwin-arm64.tar.gz	macOS Apple Silicon
velocix-0.0.1-darwin-amd64.tar.gz	macOS Intel
velocix-0.0.1-linux-amd64.tar.gz	Linux x86_64
velocix-0.0.1-linux-arm64.tar.gz	Linux ARM64