Skip to content

skanehira/github-tui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

github-tui

This is a TUI Client for GitHub. Still Under Development

If you are using Vim, you can use gh.vim instead.

Features

Implemented

  • Issue
    • list
    • create
    • close
    • open
    • open browser
    • preview
    • edit
  • Issue comment
    • list
    • preview
    • delete
    • edit
    • add
    • quote reply

Still Under Development

  • Issue
    • add assignees, labels, projects, milestone
    • remove assignees, labels, projects, milestone
  • PR
    • list
    • edit comment
    • add comment
    • delete comment
    • diff
    • create
    • close
    • change base
    • merge
  • Github Actions
    • re-run
    • list
    • log
  • File tree
    • preview
    • open browser
    • preview
  • Project
    • columns
    • open(if type is issue, pr)
    • add
    • remove
    • move
    • open browser
  • config
    • set default editor
    • set user keybindings

Installation

$ git clone https://github.com/skanehira/github-tui
$ go install ./cmd/ght

Settings

At first, please set personal access token and email in config.yaml.

github:
  token: xxxxxxxxxxxxxxxxx

The config.yaml path must be in the bellow place.

OS place
Window %AppData%¥ght¥config.yaml
Mac $HOME/Library/Application Support/ght/config.yaml
Linux/Unix $HOME/.config/ght/config.yaml

Usage

# current repository
$ ght

# specified repository
$ ght owner/repo

Keybindings

UI Keybinding Description
Common j/down arrow Move down by one row.
Common k/up arrow Move up by one row.
Common g/home Move to the top.
Common G/end Move to the bottom.
Common Ctrl-F/page down Move down by one page.
Common Ctrl-B/page up Move up by one page.
Common Ctrl-N Move next UI.
Common Ctrl-P Move previous UI.
Common Ctrl-C Finish app.
Common Ctrl-G Focus to Issues
Common Ctrl-T Focus to Filters
Filters Enter Search with enter query.
Issues h/left arrow Move left by one column.
Issues l/right arrow Move right by one column.
Issues Ctrl-J Check issue and move down.
Issues Ctrl-K Check issue and move up.
Issues e Edit and update issue body.
Issues o Open checked issue.
Issues c Close checked issue.
Issues Ctrl-O Open checked issue on browser.
Issues / filter with enter words
Issues n Create new issue.
Issues f Fetch more issue.
Comments h/left arrow Move left by one column.
Comments l/right arrow Move right by one column.
Comments Ctrl-J Check comment and move down.
Comments Ctrl-K Check comment and move up.
Comments Ctrl-O Open checked comment on browser.
Comments n Add new issue comment.
Comments e Edit and update comment body.
Comments r Quote reply comment.
Comments / filter with enter words
Preview / search with enter words
Preview n move next word
Preview N move previous word
Preview o change to full screen

Note

When you creating issue, you can specify multiple labels, projects and assignees with ,. For instance, when you specify 2 labels then must input label1,label2.

When you edit issue body with Edit Body button then $EDITOR be used. If $EDITOR is empty or not set, vim wll be used.

Author

skanehira

About

TUI client for GitHub

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages