{"id":13548843,"url":"https://github.com/muesli/gitty","last_synced_at":"2025-04-05T01:07:53.333Z","repository":{"id":39714241,"uuid":"399250986","full_name":"muesli/gitty","owner":"muesli","description":"Contextual information about your git projects, right on the command-line","archived":false,"fork":false,"pushed_at":"2023-08-07T15:12:26.000Z","size":666,"stargazers_count":536,"open_issues_count":12,"forks_count":22,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-29T00:09:38.188Z","etag":null,"topics":["cli","git","gitea","github","gitlab","terminal","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/muesli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"muesli"}},"created_at":"2021-08-23T21:21:37.000Z","updated_at":"2025-03-27T12:52:14.000Z","dependencies_parsed_at":"2024-01-07T09:37:38.306Z","dependency_job_id":"e7512495-26fd-4bbd-8ea5-c531c57f0b98","html_url":"https://github.com/muesli/gitty","commit_stats":{"total_commits":101,"total_committers":7,"mean_commits":"14.428571428571429","dds":"0.48514851485148514","last_synced_commit":"18b08b25806b21b6dad96353509de670b0fbe03b"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muesli%2Fgitty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muesli%2Fgitty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muesli%2Fgitty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muesli%2Fgitty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muesli","download_url":"https://codeload.github.com/muesli/gitty/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247271530,"owners_count":20911587,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","git","gitea","github","gitlab","terminal","tui"],"created_at":"2024-08-01T12:01:15.088Z","updated_at":"2025-04-05T01:07:53.311Z","avatar_url":"https://github.com/muesli.png","language":"Go","readme":"# gitty\n\n[![Latest Release](https://img.shields.io/github/release/muesli/gitty.svg)](https://github.com/muesli/gitty/releases)\n[![Build Status](https://github.com/muesli/gitty/workflows/build/badge.svg)](https://github.com/muesli/gitty/actions)\n[![Go ReportCard](https://goreportcard.com/badge/muesli/gitty)](https://goreportcard.com/report/muesli/gitty)\n[![GoDoc](https://godoc.org/github.com/golang/gddo?status.svg)](https://pkg.go.dev/github.com/muesli/gitty)\n\n`gitty` is a smart little CLI helper for git projects, that shows you all the\nrelevant issues, pull requests and changes at a quick glance, right on the\ncommand-line. It currently supports the GitHub, GitLab, and Gitea APIs.\n\n![Screenshot](screenshot.png)\n\n## Installation\n\n### Packages\n\n#### Linux\n- Arch Linux: [gitty](https://aur.archlinux.org/packages/gitty/)\n- Nix: `nix-env -iA nixpkgs.gitty`\n- [Packages](https://github.com/muesli/gitty/releases) in Debian \u0026 RPM formats\n\n### Binaries\n- [Binaries](https://github.com/muesli/gitty/releases) for Linux, FreeBSD, OpenBSD, macOS, Windows\n\n### From source\n\nMake sure you have a working Go environment (Go 1.17 or higher is required).\nSee the [install instructions](http://golang.org/doc/install.html).\n\nCompiling gitty is easy, simply run:\n\n    git clone https://github.com/muesli/gitty.git\n    cd gitty\n    go build\n\n## Access Tokens\n\nNote: In order to access the APIs of hosting providers like GitHub, GitLab, or\nGitea, `gitty` requires you to provide valid access tokens in an environment\nvariable called `GITTY_TOKENS`.\n\nYou can provide tokens for multiple hosts and services in this format:\n\n`github.com=abc123;gitlab.com=xyz890;myhost.tld=...`\n\n### GitHub\n\nYou can [create a new token](https://github.com/settings/tokens/new?scopes=repo:status,public_repo,read:user,read:org\u0026description=gitty)\nin your profile settings:\nDeveloper settings \u003e Personal access tokens \u003e Generate new token\n\nMake sure to enable the `repo:status`, `public_repo`, `read:user`, and\n`read:org` permissions in particular.\n\n### GitLab\n\nYou can create a new token in your profile settings:\nUser Settings \u003e Access Tokens\n\nMake sure to enable the `read_user`, `read_api`, and `read_repository`\npermissions.\n\n### Gitea\n\nYou can create a new token in your profile settings:\nSettings \u003e Applications \u003e Manage Access Tokens\n\n## Usage\n\nYou can start `gitty` with either a path or a URL as an argument. If no argument\nwas provided, `gitty` will operate on the current working directory.\n\n```bash\n$ gitty /some/repo\n$ gitty github.com/some/project\n$ gitty https://myhost.tld/some/project\n```\n\nThe following flags are supported:\n\n```\n  -max-branch-age int\n        Max age of a branch in days to be considered active (default 28)\n  -max-branches int\n        Max amount of active branches to show (default 10)\n  -max-commits int\n        Max amount of commits to show (default 10)\n  -max-issues int\n        Max amount of issues to show (default 10)\n  -max-pull-requests int\n        Max amount of pull requests to show (default 10)\n```\n\n### Open issue or pull request in browser\n\nIf you launch `gitty` with the ID of an issue or pull request, it will open the\nissue or pull request in your browser:\n\n```bash\n$ gitty [PATH|URL] 42\n```\n\n### Monitoring entire namespaces\n\ngitty also lets you monitor entire namespaces, giving you an overview of all its\nrepositories:\n\n```bash\n$ gitty --all-projects github.com\n```\n\nPer default it will show the projects of the token owner, but you can also\nretrieve the projects of other namespaces:\n\n```bash\n$ gitty --all-projects --namespace muesli github.com\n```\n\n## Feedback\n\nGot some feedback or suggestions? Please open an issue or drop me a note!\n\n* [Twitter](https://twitter.com/mueslix)\n* [The Fediverse](https://mastodon.social/@fribbledom)\n","funding_links":["https://github.com/sponsors/muesli"],"categories":["Go","cli"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuesli%2Fgitty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuesli%2Fgitty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuesli%2Fgitty/lists"}