An open API service indexing awesome lists of open source software.

https://github.com/bymehul/ghk

GitHub helper โ€” push code with ease.
https://github.com/bymehul/ghk

beginner-friendly cli command-line developer-tools git github rust

Last synced: about 14 hours ago
JSON representation

GitHub helper โ€” push code with ease.

Awesome Lists containing this project

README

          

# ghk

Simple GitHub helper โ€” push code without the complexity.


Release
License


๐Ÿ“– Documentation ยท
โฌ‡๏ธ Download

---

## Install

**No Rust required** โ€” download and run!

```bash
# Linux/macOS (recommended)
curl -sSL https://raw.githubusercontent.com/bymehul/ghk/main/install.sh | bash

# Debian/Ubuntu
wget https://github.com/bymehul/ghk/releases/latest/download/ghk_1.0.0_amd64.deb
sudo dpkg -i ghk_*.deb

# Fedora/RHEL
sudo rpm -i https://github.com/bymehul/ghk/releases/latest/download/ghk-1.0.0-1.x86_64.rpm

# Windows (PowerShell)
irm https://raw.githubusercontent.com/bymehul/ghk/main/install.ps1 | iex

# From source (requires Rust)
cargo install --git https://github.com/bymehul/ghk
```

See [INSTALL.md](INSTALL.md) for detailed instructions.

## Quick Start

```bash
ghk setup # Install git & gh if missing
ghk init # Start tracking project
ghk create # Create repo on GitHub
ghk push # Save changes
```

## Commands

| Command | Alias | Purpose | Runs... |
|---------|-------|---------|---------|
| `setup` | | Install requirements | (Checks requirements) |
| `init` | | Start tracking folder | `git init` |
| `login` / `logout` | | GitHub auth | `gh auth login` |
| `create` | | Create repo on GitHub | `gh repo create` |
| `push` | `save` | Save changes | `git add -A && git commit && git push` |
| `pull` | `sync` | Download changes | `git pull` |
| `clone ` | `download` | Download repo | `gh repo clone` |
| `status` | | Show status | `git status` |
| `diff` | | Preview changes | `git diff` |
| `history` | `log` | Show recent saves | `git log` |
| `undo` | | Undo last commit | `git reset --soft HEAD~1` |
| `open` | | Open in browser | `gh browse` |
| `branch` | | List/switch branches | `git branch` |
| `ignore` | | Add .gitignore | (Writes .gitignore) |
| `license` | | Add license file | (Writes LICENSE) |
| `config` | | View/edit settings | (Edits config) |
| `user list/switch` | | Manage accounts | (Internal auth) |
| `completions` | | Shell completions | (Generates script) |

## Options

| Flag | Effect |
|------|--------|
| `-q, --quiet` | Suppress output |
| `--nocolor` | Disable colors |
| `-h, --help` | Show help |
| `-V, --version` | Show version |

## Shell Completions

```bash
# Bash
ghk completions bash >> ~/.bashrc

# Zsh
ghk completions zsh > ~/.zfunc/_ghk

# Fish
ghk completions fish > ~/.config/fish/completions/ghk.fish
```

## Philosophy

- **No jargon** โ€” "save" not "commit"
- **One command, one thing**
- **Always asks before destructive actions**
- **Works everywhere** โ€” Linux, macOS, Windows

## License

MIT