Skip to content

Velocix v0.0.1

Choose a tag to compare

View all tags
@r-devops r-devops released this 16 Apr 06:32
· 6 commits to main since this release
v0.0.1
b44ca5f

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
Assets 6
Loading