A TUI issues, pr, projects and discussions tracker

Currently this is a WIP. And only Github integration is implemented.

Roadmap

• Switch repository remote
• customizable time format
• customizable colors
• customizable tag colors
• customizable open/closed state indicators
• Create customizable keybinds
• Add github integration
  • Issues
    • View all issues
    • Render issue tags
    • View details about issue
    • Add comment on issue
    • Add issues
    • Add tags to issue
    • Delete issue
    • Close issue
    • Set issue metadata (assignee, time tracking, ...)
  • Pull requests
    • View all pull requests
    • View details about pull request
    • Render pull request tags
    • Add comment on pull request
    • Create pull requests
    • Add tags to pull requests
    • Delete pull request
    • Close pull request
    • Merge pull reqeust
    • Set pull request metadata (assignee, time tracking, ...)
  • Projects
    • View all projects
    • View details about project
    • Move issue to new state
  • Comments
    • Edit comments
    • Add reaction to comments
    • Delete comment
• Add gitlab integration
• Add gitea integration
• Add forgejo integration

Installation

Since this is a WIP the only way to use is by compiling it yourself using: cargo build.

Github Authentication

Github authentication is best achieved by creating a personal access token(classic).

You may also use a fine grained personal access token for a more secure way to view issues and pull requests. However you wont be able to view projects.

To use all features of lazyissues you need these scopes: repo discussion projects

Configuration

Config is written in kdl and Lazyissues looks for a directory with a file in the config_local_dir named lazyissues/config.kdl.

Platform	Path
Linux	$XDG_CONFIG_HOME/lazyissues/config.kdl or $HOME/.config/lazyissues/config.kdl
MacOS	$HOME/Library/Application Support/lazyissues/config.kdl
Windows	{FOLDERID_LocalAppData}\lazyissues\config.kdl(C:\Users\Alice\AppData\Local\lazyissues\config.kdl)

Config options

github_token_path

To be able to view issues, pr's, and projects you need to set this option. The option takes one path argument pointing to the location where the personal access token file is located on your machine.

github_token_path "/path/to/github/personal_access_token"

tags

tags defines custom tags and their color for displaying on your issues and pr's. It takes an array of key value pairs where the key represents the tag name and the value represents the color that is associated with said tag. This color can be a named color, rgb values or an indexed color.

tags {
    bug "blue"
    critical "#F06996"
    documentation "10"
}

time_format

time_format declares a format in which to display the timestamps of issue, pr's, projects and comments on them. It takes any valid time format as a string. The default one is displayed down below.

time_format "%H:%M %d.%m.%Y"