A fast, configurable Git standup & activity reporting CLI written in Go.

_{Turn your local Git commits across multiple repositories into clean, daily developer reports.}

Forgot what you worked today?

gohome automates your daily status reporting by recursively scanning your workspace to find git repositories. It aggregates commit logs from multiple projects instantly and formats them into beautiful, ready-to-share reports.

Perfect for Daily Standups, Weekly Summaries, or tracking your Personal Coding Habits.

See docs/demos/ for more examples and recording guide.

v1.3 brings major architectural improvements while maintaining full backward compatibility:

• ✅ Cobra/Viper Framework: Modern CLI with subcommands (report, config, version, completion)
• ✅ Multi-Format Config: Support for JSON, YAML, and TOML configuration files
• ✅ Environment Variables: Configure via GOHOME_* environment variables (e.g., GOHOME_WORKSPACE)
• ✅ Config Management: New gohome config subcommand for easy configuration (list, get, set, reset)
• ✅ Enhanced Completions: Improved shell auto-completion with subcommand and flag support
• ✅ 100% Test Coverage: Critical packages (parser, git, renderer) fully tested

Migrating from v1.2? See docs/v1.3_MIGRATION_GUIDE.md for detailed migration instructions.

• 🚀 Auto-Discovery: Recursively finds git repositories in your workspace (configurable depth, default 2 levels).
• 🎯 Smart Scanning: Skip nested repos and ignore common directories (.git, .vscode, node_modules).
• ⚡️ Fast Performance: Lightweight scanner optimized for large workspace structures like github.com/{org}/{repo}.
• 🌱 Branch Support: Include commits from all local branches or filter by specific branch.
• 🎨 Rich Output: Supports multiple formats (text, table) and styles (normal, markdown).
• 📋 Clipboard Ready: Copy reports directly to your system clipboard with --copy.
• 📝 Custom Tasks: Add manual tasks alongside git commits for complete daily reports.
• ⚙️ Smart Config: Multi-format support (JSON, YAML, TOML) with environment variables (GOHOME_*) and config management commands.
• 🐚 Shell Completions: Auto-completion for bash, zsh, fish, and PowerShell.
• 🎯 Modern CLI: Built with Cobra/Viper for intuitive subcommands and better UX.

Linux/macOS:

curl -sS https://get.ngockhoi96.dev/gohome | sh

The install script will:

• Auto-detect your platform (Linux/macOS, x86_64/arm64)
• Download the latest release from GitHub
• Install to /usr/local/bin (may require sudo)
• Clean up any conflicting dev builds in $GOPATH/bin
• Automatically upgrade existing installations when run again

Windows (PowerShell):

irm https://raw.githubusercontent.com/anIcedAntFA/gohome/main/scripts/install.ps1 | iex

The PowerShell script will:

• Auto-detect your architecture (x64/arm64)
• Download and extract the latest release
• Install to %LOCALAPPDATA%\Programs\gohome
• Automatically add to PATH
• Clean up conflicting dev builds

If you have Node.js and npm installed:

npm install -g @ngockhoi96/gohome

Or using npx (no installation required):

npx @ngockhoi96/gohome --help

For Arch Linux users, install from the AUR:

# Using yay
yay -S gohome

# Or using pacman
pacman -S gohome

# Or manually
git clone https://aur.archlinux.org/gohome.git
cd gohome
makepkg -si

If you have Go 1.21+ installed:

go install github.com/anIcedAntFA/gohome/cmd/gohome@latest

⚠️ Path Configuration: When using production releases (installed via curl or binary download), ensure /usr/local/bin comes before $GOPATH/bin in your $PATH to avoid conflicts with dev builds.

Shell Configuration Examples:

Bash (~/.bashrc or ~/.bash_profile)

# Go environment
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin  # Append GOPATH/bin (lower priority)

Zsh (~/.zshrc)

# Go environment
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin  # Append GOPATH/bin (lower priority)

Fish (~/.config/fish/config.fish)

# Go environment
set -gx GOPATH $HOME/go
set -gx PATH $PATH $GOPATH/bin  # Append GOPATH/bin (lower priority)
# Or use fish_add_path for better management:
# fish_add_path -aP $GOPATH/bin

PowerShell (Windows - run as Administrator)

# Check current PATH
$env:Path

# Add Go bin to PATH (User level - persists across sessions)
$goPath = "$env:USERPROFILE\go\bin"
[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", "User") + ";$goPath",
    "User"
)

# Reload PATH in current session
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","User")

Note: The install.ps1 script automatically adds gohome to PATH.

After updating your shell config, reload it:

# Bash
source ~/.bashrc

# Zsh
source ~/.zshrc

# Fish
source ~/.config/fish/config.fish

# PowerShell
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","User")

Download pre-built binaries from GitHub Releases:

1. Download the appropriate archive for your OS/architecture
2. Extract the binary
3. Move to a directory in your $PATH:

Linux/macOS:

# Extract
tar -xzf gohome_*_linux_x86_64.tar.gz
# Move to PATH
sudo mv gohome /usr/local/bin/
# Make executable
chmod +x /usr/local/bin/gohome

Windows:

# Extract the .zip file
# Move gohome.exe to a directory in your PATH

gohome --version
# Production release: gohome v1.0.1
# Dev build: gohome abc1234 (commit: abc1234, built: 2026-01-10)

The version format differs based on how it was built:

• Production releases show clean version only
• Development builds include commit hash and build date for debugging

Enable tab completion for commands, subcommands, and flag values. v1.3 includes improved completions with full support for:

• Commands: gohome <TAB> → shows report, config, version, completion
• Subcommands: gohome config <TAB> → shows list, get, set, reset
• Flags: gohome --<TAB> → shows all available flags
• Values: gohome --format=<TAB> → shows text, table

Fish:

# One-time setup
gohome completion fish > ~/.config/fish/completions/gohome.fish

# Or load temporarily for this session
gohome completion fish | source

Bash:

# Linux
gohome completion bash | sudo tee /etc/bash_completion.d/gohome

# macOS
gohome completion bash > $(brew --prefix)/etc/bash_completion.d/gohome

# Or add to ~/.bashrc for current user only
echo 'source <(gohome completion bash)' >> ~/.bashrc
source ~/.bashrc

Zsh:

# Enable completions (if not already enabled)
echo "autoload -U compinit; compinit" >> ~/.zshrc

# Install completion
gohome completion zsh > "${fpath[1]}/_gohome"

# Restart shell or reload
exec zsh

PowerShell:

# Add to PowerShell profile
gohome completion powershell | Out-String | Invoke-Expression

# Or save permanently
Add-Content $PROFILE "gohome completion powershell | Out-String | Invoke-Expression"

What you get with completions:

• Command completion: gohome <tab> shows config, report, version, completion
• Subcommand completion: gohome config <tab> shows get, set, list, reset
• Config key completion: gohome config get <tab> shows all 17 config keys
• Flag value completion: gohome --format <tab> shows text, table
• Style completion: gohome --style <tab> shows normal, markdown

Simply run the tool in your workspace directory:

gohome

1️⃣ Basic Usage (Last 1 day)

gohome

2️⃣ Look back 1 week

gohome -w 1

3️⃣ Generate a Table Report

gohome -f table -s markdown

4️⃣ Copy to Clipboard

This is useful for pasting directly into Slack/Teams/Discord:

gohome -d 1 --copy

5️⃣ Add Custom Tasks

Add tasks that aren't tracked in git:

gohome -t "Meeting: Sprint Planning" -t "Review: PR #123"

6️⃣ Include All Local Branches

By default, gohome only shows commits from your current branch. Use -b to include commits from all local branches:

gohome -d 2 -b

This is useful when:

• You have commits on feature branches not yet merged
• You want to see all your work across multiple branches
• You're generating a standup report before merging PRs

7️⃣ Filter by Specific Branch

Filter commits from a specific branch instead of the current one:

gohome -d 3 --branch feature/new-ui

Useful for reviewing work on a specific feature branch without checking it out.

8️⃣ Customize Scan Depth

Control how deep gohome scans for repositories (default: 2 levels):

# Scan only 1 level deep (faster for flat structures)
gohome --max-depth 1

# Scan 3 levels deep for deeper nested repos
gohome --max-depth 3 -d 2

Useful when:

• You have a flat workspace structure (use --max-depth 1)
• You have deeply nested projects (increase to 3 or 4)
• You want faster scans by limiting depth

9️⃣ Save Settings

Save your favorite flags as default (so you don't have to type them next time):

gohome -p /Users/ngockhoi96/workspace -d 1 -f table --max-depth 2 --save

gohome supports multiple configuration file formats: JSON, YAML, and TOML.

The config file should be named .gohome with the appropriate extension in your home directory:

• ~/.gohome.json (JSON format)
• ~/.gohome.yaml or ~/.gohome.yml (YAML format)
• ~/.gohome.toml (TOML format)

You can create it manually or use the --save flag to auto-generate a JSON config file.

Format Precedence: If multiple config files exist, gohome will use the first one found in this order: .json > .toml > .yaml > .yml

{
  "hours": 0,
  "days": 1,
  "weeks": 0,
  "months": 0,
  "years": 0,
  "today": false,
  "path": "/Users/ngockhoi96/workspace",
  "author": "ngockhoi96",
  "format": "table",
  "preset": "normal",
  "max_depth": 2,
  "show_icon": true,
  "show_scope": false,
  "copy_to_clipboard": false,
  "all_branches": false,
  "branch": "",
  "tasks": [
    {
      "type": "meeting",
      "message": "Daily Standup & Team Sync",
      "icon": "📅",
      "enabled": true
    },
    {
      "type": "review",
      "message": "Code Review & PR Feedback",
      "icon": "👀",
      "enabled": true
    }
  ]
}

# Time period (only one should be set)
hours: 0
days: 1
weeks: 0
months: 0
years: 0
today: false

# Path and scanning
path: /Users/ngockhoi96/workspace
max_depth: 2
author: ngockhoi96

# Output formatting
format: table
style: normal
icon: true
scope: false

# Branch filtering
all_branches: false
branch: ""

# Clipboard
copy: false

# Static recurring tasks
tasks:
  - type: meeting
    message: "Daily Standup & Team Sync"
    icon: "📅"
    enabled: true
    
  - type: review
    message: "Code Review & PR Feedback"
    icon: "👀"
    enabled: true

# Time period (only one should be set)
hours = 0
days = 1
weeks = 0
months = 0
years = 0
today = false

# Path and scanning
path = "/Users/ngockhoi96/workspace"
max_depth = 2
author = "ngockhoi96"

# Output formatting
format = "table"
style = "normal"
icon = true
scope = false

# Branch filtering
all_branches = false
branch = ""

# Clipboard
copy = false

# Static recurring tasks
[[tasks]]
type = "meeting"
message = "Daily Standup & Team Sync"
icon = "📅"
enabled = true

[[tasks]]
type = "review"
message = "Code Review & PR Feedback"
icon = "👀"
enabled = true

Manage your configuration easily with the new config subcommand:

# View all current settings
gohome config list

# Get specific setting
gohome config get workspace
gohome config get days
gohome config get format

# Set configuration values
gohome config set workspace /home/user/projects
gohome config set days 7
gohome config set format table
gohome config set style markdown

# Reset to default values
gohome config reset

Benefits:

• No need to manually edit JSON/YAML/TOML files
• Automatic validation of configuration values
• Easy viewing and updating of settings
• Quick reset to defaults

Note: By default (without -b or --branch), gohome shows commits from your current branch only. Use -b to include all local branches, or --branch <name> to filter by a specific branch.

v1.3 introduces full environment variable support for all configuration options. Set values using the GOHOME_ prefix.

All configuration options can be set via environment variables with the GOHOME_ prefix. This is especially useful for:

• CI/CD pipelines (avoid creating config files)
• Docker containers (pass config through env vars)
• Team consistency (shared defaults across developers)
• Temporary overrides (quick testing without changing config files)

Configuration Precedence: CLI Flags > Environment Variables > Config File > Defaults

Quick Example:

# Set via environment
export GOHOME_WORKSPACE=/home/user/projects
export GOHOME_AUTHOR="John Doe"
export GOHOME_DAYS=7
export GOHOME_FORMAT=table
export GOHOME_STYLE=markdown

# Run without flags
gohome  # Uses all env var values

Permanent Setup (add to ~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish):

# Bash/Zsh
export GOHOME_WORKSPACE=~/projects
export GOHOME_AUTHOR="$(git config user.name)"
export GOHOME_FORMAT=table
export GOHOME_STYLE=markdown

# Fish
set -x GOHOME_WORKSPACE ~/projects
set -x GOHOME_AUTHOR (git config user.name)
set -x GOHOME_FORMAT table
set -x GOHOME_STYLE markdown

# Set defaults via environment
export GOHOME_DAYS=7
export GOHOME_FORMAT=table
export GOHOME_STYLE=markdown
gohome  # Uses env var values

# Override env var with flag
export GOHOME_DAYS=7
gohome --days 3  # Flag wins: uses 3 days

# Useful for CI/CD
export GOHOME_PATH=/workspace
export GOHOME_AUTHOR=ci-bot
export GOHOME_FORMAT=table
gohome --today

# Docker usage
docker run -e GOHOME_DAYS=7 -e GOHOME_FORMAT=table gohome:latest

See ROADMAP.md for the full development plan and upcoming features.

Contributions are welcome! We appreciate bug reports, feature requests, documentation improvements, and code contributions.

For detailed guidelines on:

• Development setup and workflow
• Coding standards and conventions
• Commit message format (Conventional Commits with emojis)
• Pull request process
• Testing and quality assurance

Please see CONTRIBUTING.md for the complete guide.

# 1. Fork and clone
git clone https://github.com/YOUR_USERNAME/gohome.git
cd gohome

# 2. Install dependencies
go mod tidy

# 3. Create feature branch
git checkout -b feat/amazing-feature

# 4. Make changes and test
make build
make test
make lint

# 5. Commit using Conventional Commits
git commit -m '✨ feat(scanner): add amazing feature'

# 6. Push and open PR
git push origin feat/amazing-feature

gohome is heavily inspired by the awesome git-standup utility by Kamran Ahmed.

While git-standup is great, gohome was built to address specific personal needs for daily reporting, such as:

• Rich formatting: Tables, icons, and custom styles.
• Workflow integration: Direct clipboard support.
• Smart config: Persisted settings for zero-setup runs.

This project also serves as a practical journey to master Go (Golang), implementing concepts like Concurrency, CLI architecture, and Cross-platform distribution.

This project is licensed under the MIT License - see the LICENSE file for details.