ghcli (GitHubCLI)

A fast, terminal-based user interface (TUI) for managing your GitHub repositories, written in Rust using Ratatui.

Features

• Profile Overview: View your GitHub user info, bio, followers, and public repository counts.
• Repository Management: List, search, and navigate through all your GitHub repositories.
• Create: Easily create new public or private repositories directly from the terminal.
• Clone: Clone repositories to your local machine with custom directory paths.
• Git Integration: Initialize git in the current directory and instantly add your repository as a remote.
• Browser Integration: Quickly open a repository in your default web browser.
• Delete: Delete repositories securely with built-in confirmation prompts.
• Search: Fast repository lookup moving you directly to your matches.

Prerequisites

• Rust & Cargo (to build from source)
• Git (for cloning and adding remotes)

Installation

From crates.io (recommended)

Install the latest published release directly:

cargo install ghcli

Using Make

You can quickly build and install ghcli to your ~/.local/bin folder using the provided Makefile. Make sure ~/.local/bin is in your system's PATH.

git clone https://github.com/rishalsha/GitHubCLI.git
cd GitHubCLI
make install

Using Cargo

Alternatively, you can build it using cargo:

cargo build --release

The compiled binary will be placed in target/release/ghcli.

Authentication

When you first run ghcli, it will guide you through an authentication flow to obtain a GitHub Personal Access Token (PAT) and save it locally.

To force re-authentication or provide a new token/cookie:

ghcli --auth

Keybindings

License

This project is licensed under the MIT License.