Skip to content

Latest commit

 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Goober

A badass file watcher for Go projects that automatically rebuilds and restarts your application. It comes with a slick terminal UI to show logs and build status.

🚀 Installation

Install Goober globally:

go install github.com/jerkeyray/goober@latest

Make sure your Go bin directory (usually $HOME/go/bin) is in your PATH. If not:

export PATH="$HOME/go/bin:$PATH"

Add that to your .zshrc, .bashrc, or whatever shell config you use.

⚡ Quick Start

Navigate to your Go project and just run:

goober

It will:

  • Watch for file changes
  • Rebuild the project
  • Restart your app
  • Show logs in a terminal UI

Examples

# Watch current directory and use default build/run
goober

# Watch a specific directory
goober --dir ./myapp

# Use custom build and run commands
goober --build "go build -o myapp" --run "./myapp"

# Set a custom debounce time (e.g., 1 second)
goober --debounce 1s

# Disable the TUI, use plain logs
goober --no-tui

🛠️ CLI Flags

  • --dir <path> — Directory to watch (default: .)
  • --build <command> — Build command (default: go build -o app)
  • --run <command> — Run command (default: ./app)
  • --debounce <duration> — Delay after file changes before restarting (default: 750ms)
  • --no-tui — Disable the terminal UI and use plain output

🎮 TUI Keybindings

When using the terminal UI:

  • q / Ctrl+C — Quit
  • r — Force manual restart
  • c — Clear logs
  • / or j/k — Scroll logs
  • PgUp / PgDown — Scroll a page up/down

About

nodemon for go

Resources

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages