Hubbit

A command-line tool for managing Git repositories and GitHub release binaries. Because typing full URLs is so last decade.

Features

• Smart Repository Cloning: Clone repos with minimal typing

  • Just the repo name: hubbit clone myrepo (uses your configured GitHub username)
  • Owner/repo format: hubbit clone torvalds/linux
  • Full URLs: hubbit clone https://github.com/user/repo
  • SSH URLs: hubbit clone git@github.com:user/repo.git

• Binary Management: Download and update GitHub release binaries

  • Download latest: hubbit binary get cli/cli
  • Update specific binary: hubbit binary update user/tool
  • Update all binaries: hubbit binary update

• Flexible Configuration: Customize behavior via ~/.config/hubbit/config.yaml

• Cross-Platform: Works on Linux, macOS, and Windows

Installation

From Release

Download the latest binary from the releases page.

From Source

go install github.com/daveio/hubbit@latest

Configuration

Create ~/.config/hubbit/config.yaml:

main:
  external_git: true # Use git CLI instead of built-in library

github:
  username: yourusername
  token: your-github-token # Optional, for private repos
  protocol: ssh # or https
  clone_directory: ~/src

Usage

Clone a Repository

# Using your configured username
hubbit clone myrepo

# Explicit owner/repo
hubbit clone daveio/hubbit

# From URL
hubbit clone https://github.com/user/repo
hubbit clone git@github.com:user/repo.git

Manage Binaries

# Download latest binary for a repo
hubbit binary get owner/repo

# Update a specific binary
hubbit binary update owner/repo

# Update all installed binaries
hubbit binary update

Options

• -v, --verbose: Enable verbose output
• --config: Use a custom config file

Binary Detection

Hubbit automatically detects the appropriate binary for your platform:

• Matches OS (linux, darwin/macos, windows)
• Matches architecture (amd64/x86_64, arm64/aarch64)
• Handles archives (.tar.gz, .zip) and plain binaries
• Installs to ~/.local/bin

Development

Prerequisites

• Go 1.24 or later
• Git (for external git mode)
• golangci-lint (for linting)

Building

go build .

Testing

go test ./...

Linting

golangci-lint run

Planned Features

• Repository management.
  • Maintain a list of repos we are managing in ~/.config/hubbit/repositories.yaml.
  • Fetch and pull them all.
  • Check for local changes beforehand and only fetch.
  • git fetch --all --tags --prune --recurse-submodules=yes.
  • git pull --all --tags --prune --recurse-submodules=yes.
• Shell integration.
  • We already generate completions.
  • This would let us install binaries somewhere other than ~/.local/bin.
  • bash, zsh, fish as core platforms.
  • xonsh, nu, powershell as additional platforms.
• Support for other Git platforms (GitLab, Bitbucket).
• Binary version picking.
• Repository statistics.

Planned Fixes

• Fetch GitHub token from gh auth token or $GITHUB_TOKEN in the environment.
• Clone with --recurse-submodules.
• Fix external_git: true which breaks trying to interact with the SSH agent.
  • Will probably remove internal git library and always shell out instead.
• Fix binary installation; breaks with jdx/mise, installs the fish activation script.
• Create config file with defaults if it doesn't exist.
  • Also create binaries.yaml with an empty dict: binaries: {}
• HTTPS clone on private repo asks for credentials, we should be using the token.
  • HTTPS clone on public repo works fine.

License

Hubbit is licensed under the MIT License.