repo.fish

A Fish shell plugin to simplify git repository management.

Features

• Clone repositories with a consistent directory structure
• Navigate to repositories quickly
• Create new git repositories
• Open repositories in your browser
• List all your repositories
• Customizable hooks for post-clone, post-goto, and post-new actions

Installation

Install with Fisher:

fisher install abs3ntdev/repo.fish

Usage

Basic Commands

# Clone a repository
repo get github.com/user/repo

# Navigate to a repository
repo go github.com/user/repo

# Create a new repository
repo new github.com/user/myrepo

# Open current repository in browser
repo open

# Clone an AUR repository
repo aur package-name

# List all repositories
repo list

# Show help
repo help

Configuration

By default, all repositories are stored in ~/repos. You can change this by setting the $REPO_BASE_DIR variable in your config.fish:

set -gx REPO_BASE_DIR ~/path/to/repos

Custom Hooks

repo.fish provides three hooks that you can customize:

1. Post-clone hook: Runs after cloning a repository
2. Post-goto hook: Runs after navigating to a repository
3. Post-new hook: Runs after creating a new repository

To use hooks, define the following functions:

# Define a custom post-clone hook
function repo_post_clone
    echo "Repository cloned to: $argv[1]"
    # Your custom actions here
    cd $argv[1]
    # You can run additional commands like:
    # npm install
    # bundle install
    # etc.
end

# Define a custom post-goto hook
function repo_post_goto
    echo "Navigated to: $argv[1]"
    # Your custom actions here
    cd $argv[1]
    # You can run additional commands like:
    # git status
    # ls -la
    # etc.
end

# Define a custom post-new hook
function repo_post_new
    echo "Created new repository at: $argv[1]"
    # Your custom actions here
    cd $argv[1]
    # You can run additional commands like:
    # touch README.md
    # git add README.md
    # git commit -m "Initial commit"
    # etc.
end

If you don't define these functions, the default behavior is to change to the repository directory.

License

MIT