{"id":22076039,"url":"https://github.com/mantono/giss","last_synced_at":"2025-07-24T12:32:37.790Z","repository":{"id":47228926,"uuid":"219608819","full_name":"mantono/giss","owner":"mantono","description":"List GitHub issues from the command line","archived":false,"fork":false,"pushed_at":"2025-04-08T07:26:28.000Z","size":423,"stargazers_count":14,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-14T05:20:45.772Z","etag":null,"topics":["api","cli","github","issues","pull-req","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/mantono.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-04T22:29:10.000Z","updated_at":"2025-04-08T07:26:31.000Z","dependencies_parsed_at":"2022-08-31T15:10:18.742Z","dependency_job_id":"a92eafc2-4bd0-442b-b147-f98d86c20d37","html_url":"https://github.com/mantono/giss","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mantono/giss","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mantono%2Fgiss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mantono%2Fgiss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mantono%2Fgiss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mantono%2Fgiss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mantono","download_url":"https://codeload.github.com/mantono/giss/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mantono%2Fgiss/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266844016,"owners_count":23993961,"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","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["api","cli","github","issues","pull-req","rust"],"created_at":"2024-11-30T22:11:58.755Z","updated_at":"2025-07-24T12:32:37.483Z","avatar_url":"https://github.com/mantono.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# giss\n*giss* is command line client to list GitHub issues and pull requests.\n\n## Usage\nAll commands requires a valid [GitHub API token](https://github.com/settings/tokens). The application will automatically read the environment variable\n`GITHUB_TOKEN`, but it can also be given when invoking the application with the `-t` or `--token` flag.\n\n### Token Permissions\n#### Classic Tokens\nThe token needs the permission `read:org` for reading **public** repositories. For **private** repositories is the `repo` permission also required.\n\n| Permission | Required |\n| :--------: | :------: |\n| `read:org` | Yes      |\n| `repo`     | Only for private repository access |\n\n#### Fine-Grained Tokens\nThe following _repository_ **read** permissions are required:\n - Issues\n - Metadata\n - Pull requests\n### List Issues \u0026 Pull Requests\nBy default, simply invoking the name of the binary, `giss`, will list tickets that are either\n- issues\n- pull requets\n- review requests\n\nin the current repo.\nIf the command is not invoked from a Git repository, an explicit repository will have to given as an argument.\n\n- `giss` - List open tickets in current repo\n- `giss mantono/giss` - List open tickets in repository _giss_ that belongs to user/organization _mantono_\n- `giss apple` - List open tickets in any repository in organization _apple_\n- `giss apple microsoft google` - List tickets in any repository in organizations _apple_, _microsoft_ and _google_\n- `giss rust-lang/rust apple/swift golang/go` - List open tickets in repositories for rust, swift and go\n- `giss -c` - List only closed tickets in current repo\n- `giss -oc` - List both open and closed tickets in current repo\n- `giss -a` - List only open tickets assigned to user\\* in current repo\n- `giss -i` - List only open issues in current repo\n- `giss -p` - List only open pull requests in current repo\n- `giss -r` - List only review requests for user\\*\n- `giss -a kotlin` - List all open tickets assigned to user in any repository in orgranization _kotlin_\n\n\\*the user is determined by the owner of the token, unless overriden with the `--user` flag.\n\nSee `giss --help` for all available options.\n\n```\nUSAGE:\n    giss [FLAGS] [OPTIONS] [--] [target]...\n\nFLAGS:\n    -a, --assigned\n            Assigned only\n\n            Only include issues and pull requests assigned to user\n    -c, --closed\n            Show closed issues or pull requests\n\n            Include issues, pull request or review requests that are closed or merged\n    -D, --debug\n            Prind debug information\n\n            Print debug information about current build for binary, useful for when an issue is encountered and reported\n    -h, --help\n            Prints help information\n\n    -i, --issues\n            List issues\n\n    -L, --links\n            Show links\n\n            Show links to each issue or pull request in the output\n    -o, --open\n            Show open issues or pull requests\n\n            Include issues, pull request or review requests that are open. If neither this flag nor --closed/-c is\n            given, default behavior will be to display open issues or pull requests.\n    -p, --pull-requests\n            List pull requests\n\n    -r, --review-requests\n            List review requests\n\n    -V, --version\n            Prints version information\n\n\nOPTIONS:\n        --colors \u003ccolors\u003e\n            Set use of colors\n\n            Enable or disable output with colors. By default, the application will try to figure out if colors are\n            supported by the terminal in the current context, and use it if possible. Possible values are \"on\", \"true\",\n            \"off\", \"false\", \"auto\". [default: auto]\n    -l, --labels \u003clabels\u003e...\n            Filter by label\n\n            Only include issues, pull requests or review reuests which has (all) the given label(s).\n    -n, --limit \u003climit\u003e\n            Limit the number of issues or pull requests to list [default: 10]\n\n    -O, --order \u003corder\u003e\n            Ordering\n\n            Can be either ascending (asc|ascending) or decending (desc|descending)\n    -P, --project \u003cproject\u003e\n            Filter by project\n\n            Only include isses, pull request or review requests which is assoicated with the given project.\n    -S, --search \u003csearch\u003e\n            Search\n\n            Search by a string, which must be present either in the title or the body of an issue or pull request.\n    -s, --sort-by \u003csort-by\u003e\n            Sort by\n\n            Sort by any of the following properties; \"created\", \"updated\", \"comments\", \"reactions\"\n    -t, --token \u003ctoken\u003e\n            GitHub API token\n\n            API token that will be used when authenticating towards GitHub's API [env: GITHUB_TOKEN]\n    -u, --user \u003cuser\u003e\n            Username\n\n            Username to use for the query. Will default to the username for the user of the token.\n    -v, --verbosity \u003cverbosity\u003e\n            Set verbosity level, 0 - 5\n\n            Set the verbosity level, from 0 (least amount of output) to 5 (most verbose). Note that logging level\n            configured via RUST_LOG overrides this setting. [default: 1]\n\nARGS:\n    \u003ctarget\u003e...\n            Name of target(s)\n\n            Name of the targets for the action. Can be a combination of one or several repositories, organizations or\n            users. Any repository specified must be qualified with the owner or organization name. For example\n            'org/repo'. When no target is specified, repository in current directory will be used, if possible.\n```\n\n## Building\nThe application is built with cargo. Simply run the following command in the project directory.\n```bash\ncargo build --release\n```\nA binary will be created and put in directory `target/release`.\n\n\n## Install\nRun `cargo install --path .`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmantono%2Fgiss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmantono%2Fgiss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmantono%2Fgiss/lists"}