Skip to content

v0.0.4

Choose a tag to compare

View all tags
@r-devops r-devops released this 27 May 03:18
· 1 commit to main since this release
v0.0.4
b7bffb8

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.

Assets 6
Loading