[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-10363":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":47,"readmeContent":48,"aiSummary":49,"trendingCount":16,"starSnapshotCount":16,"syncStatus":18,"lastSyncTime":50,"discoverSource":51},10363,"gitsome","donnemartin\u002Fgitsome","donnemartin","A supercharged Git\u002FGitHub command line interface (CLI).  An official integration for GitHub and GitHub Enterprise: https:\u002F\u002Fgithub.com\u002Fworks-with\u002Fcategory\u002Fdesktop-tools","",null,"Python",7673,442,112,46,0,1,2,4,3,67.34,"Other",false,"master",true,[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],"cli","cli-app","client","command-line","developer-tools","development","git","github","github-api","github-client","github-enterprise","linux","macos","programming","python","shell","terminal","utilities","utility","windows","2026-06-12 04:00:49","\u003Cp align=\"center\">\n  \u003Cimg src=\"http:\u002F\u002Fi.imgur.com\u002F0SXZ90y.gif\">\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  An \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fworks-with\u002Fcategory\u002Fdesktop-tools\">Official Integration\u003C\u002Fa> for GitHub and \u003Ca href=\"#for-github-enterprise-users\">GitHub Enterprise\u003C\u002Fa>.\n\u003C\u002Fp>\n\ngitsome\n=======\n\n[![Build Status](https:\u002F\u002Ftravis-ci.org\u002Fdonnemartin\u002Fgitsome.svg?branch=master)](https:\u002F\u002Ftravis-ci.org\u002Fdonnemartin\u002Fgitsome) [![PyPI version](https:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fgitsome.svg)](http:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fgitsome) [![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fpyversions\u002Fgitsome.svg)](https:\u002F\u002Fpypi.python.org\u002Fpypi\u002Fgitsome\u002F) [![License](https:\u002F\u002Fimg.shields.io\u002F:license-apache-blue.svg)](http:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0.html)\n\n## Why `gitsome`?\n\n### The Git Command Line\n\nAlthough the standard Git command line is a great tool to manage your Git-powered repos, it can be **tough to remember the usage** of:\n\n* 150+ porcelain and plumbing commands\n* Countless command-specific options\n* Resources such as tags and branches\n\nThe Git command line **does not integrate with GitHub**, forcing you to toggle between command line and browser.\n\n## `gitsome` - A Supercharged Git\u002FGitHub CLI With Autocomplete\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fdonnemartin\u002Fgitsome\u002Fdevelop\u002Fimages\u002Flogo.png\">\n\u003C\u002Fp>\n\n`gitsome` aims to supercharge your standard git\u002Fshell interface by focusing on:\n\n* **Improving ease-of-use**\n* **Increasing productivity**\n\n### Deep GitHub Integration\n\nNot all GitHub workflows work well in a terminal; `gitsome` attempts to target those that do.\n\n`gitsome` includes 29 GitHub integrated commands that work with **[ALL](#enabling-gh-tab-completions-outside-of-gitsome)** shells:\n\n    $ gh \u003Ccommand> [param] [options]\n\n* [Quick reference](#github-integration-commands-quick-reference)\n* [General reference](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md)\n\nRun `gh` commands along with [Git-Extras](https:\u002F\u002Fgithub.com\u002Ftj\u002Fgit-extras\u002Fblob\u002Fmaster\u002FCommands.md) and [hub](https:\u002F\u002Fhub.github.com\u002F) commands to unlock even more GitHub integrations!\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FsG09AJH.png)\n\n### Git and GitHub Autocompleter With Interactive Help\n\nYou can run the \u003Cu>**optional**\u003C\u002Fu> shell:\n\n     $ gitsome\n\nto enable **autocompletion** and **interactive help** for the following:\n\n* Git commands\n* Git options\n* Git branches, tags, etc\n* [Git-Extras commands](https:\u002F\u002Fgithub.com\u002Ftj\u002Fgit-extras\u002Fblob\u002Fmaster\u002FCommands.md)\n* [GitHub integration commands](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md)\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002F08OMNjz.png)\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FfHjMwlh.png)\n\n### General Autocompleter\n\n`gitsome` autocompletes the following:\n\n* Shell commands\n* Files and directories\n* Environment variables\n* Man pages\n* Python\n\nTo enable additional autocompletions, check out the [Enabling Bash Completions](#enabling-bash-completions) section.\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002Fhg1dpk6.png)\n\n## Fish-Style Auto-Suggestions\n\n`gitsome` supports Fish-style auto-suggestions.  Use the `right arrow` key to complete a suggestion.\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FZRaFGpY.png)\n\n## Python REPL\n\n`gitsome` is powered by [`xonsh`](https:\u002F\u002Fgithub.com\u002Fscopatz\u002Fxonsh), which supports a Python REPL.\n\nRun Python commands alongside shell commands:\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FNYk7WYO.png)\n\nAdditional `xonsh` features can be found in the [`xonsh tutorial`](http:\u002F\u002Fxon.sh\u002Ftutorial.html).\n\n## Command History\n\n`gitsome` keeps track of commands you enter and stores them in `~\u002F.xonsh_history.json`.  Use the up and down arrow keys to cycle through the command history.\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002Fwq0caZu.png)\n\n## Customizable Highlighting\n\nYou can control the ansi colors used for highlighting by updating your `~\u002F.gitsomeconfig` file.\n\nColor options include:\n\n```\n'black', 'red', 'green', 'yellow',\n'blue', 'magenta', 'cyan', 'white'\n```\n\nFor no color, set the value(s) to `None`.  `white` can appear as light gray on some terminals.\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FBN1lfEf.png)\n\n## Available Platforms\n\n`gitsome` is available for Mac, Linux, Unix, [Windows](#windows-support), and [Docker](#running-as-docker-container).\n\n## TODO\n\n>Not all GitHub workflows work well in a terminal; `gitsome` attempts to target those that do.\n\n* Add additional GitHub API integrations\n\n`gitsome` is just getting started.  Feel free to [contribute!](#contributing)\n\n## Index\n\n### GitHub Integration Commands\n\n* [GitHub Integration Commands Syntax](#github-integration-commands-syntax)\n* [GitHub Integration Commands Listing](#github-integration-commands-listing)\n* [GitHub Integration Commands Quick Reference](#github-integration-commands-quick-reference)\n* [GitHub Integration Commands Reference in COMMANDS.md](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md)\n    * [`gh configure`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-configure)\n    * [`gh create-comment`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-create-comment)\n    * [`gh create-issue`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-create-issue)\n    * [`gh create-repo`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-create-repo)\n    * [`gh emails`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-emails)\n    * [`gh emojis`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-emojis)\n    * [`gh feed`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-feed)\n    * [`gh followers`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-followers)\n    * [`gh following`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-following)\n    * [`gh gitignore-template`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-gitignore-template)\n    * [`gh gitignore-templates`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-gitignore-templates)\n    * [`gh issue`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-issue)\n    * [`gh issues`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-issues)\n    * [`gh license`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-license)\n    * [`gh licenses`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-licenses)\n    * [`gh me`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-me)\n    * [`gh notifications`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-notifications)\n    * [`gh octo`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-octo)\n    * [`gh pull-request`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-pull-request)\n    * [`gh pull-requests`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-pull-requests)\n    * [`gh rate-limit`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-rate-limit)\n    * [`gh repo`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-repo)\n    * [`gh repos`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-repos)\n    * [`gh search-issues`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-search-issues)\n    * [`gh search-repos`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-search-repos)\n    * [`gh starred`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-starred)\n    * [`gh trending`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-trending)\n    * [`gh user`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-user)\n    * [`gh view`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-view)\n* [Option: View in a Pager](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#option-view-in-a-pager)\n* [Option: View in a Browser](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#option-view-in-a-browser)\n\n### Installation and Tests\n\n* [Installation](#installation)\n    * [Pip Installation](#pip-installation)\n    * [Virtual Environment Installation](#virtual-environment-installation)\n    * [Running as a Docker Container](#running-as-a-docker-container)\n    * [Running the `gh configure` Command](#running-the-gh-configure-command)\n        * [For GitHub Enterprise Users](#for-github-enterprise-users)\n    * [Enabling Bash Completions](#enabling-bash-completions)\n    * [Enabling `gh` Tab Completions Outside of `gitsome`](#enabling-gh-tab-completions-outside-of-gitsome)\n        * [For Zsh Users](#for-zsh-users)\n    * [Optional: Installing `PIL` or `Pillow`](#optional-installing-pil-or-pillow)\n    * [Supported Python Versions](#supported-python-versions)\n    * [Supported Platforms](#supported-platforms)\n    * [Windows Support](#windows-support)\n* [Developer Installation](#developer-installation)\n    * [Continuous Integration](#continuous-integration)\n    * [Unit Tests and Code Coverage](#unit-tests-and-code-coverage)\n    * [Documentation](#documentation)\n\n### Misc\n\n* [Contributing](#contributing)\n* [Credits](#credits)\n* [Contact Info](#contact-info)\n* [License](#license)\n\n## GitHub Integration Commands Syntax\n\nUsage:\n\n    $ gh \u003Ccommand> [param] [options]\n\n## GitHub Integration Commands Listing\n\n```\n  configure            Configure gitsome.\n  create-comment       Create a comment on the given issue.\n  create-issue         Create an issue.\n  create-repo          Create a repo.\n  emails               List all the user's registered emails.\n  emojis               List all GitHub supported emojis.\n  feed                 List all activity for the given user or repo.\n  followers            List all followers and the total follower count.\n  following            List all followed users and the total followed count.\n  gitignore-template   Output the gitignore template for the given language.\n  gitignore-templates  Output all supported gitignore templates.\n  issue                Output detailed information about the given issue.\n  issues               List all issues matching the filter.\n  license              Output the license template for the given license.\n  licenses             Output all supported license templates.\n  me                   List information about the logged in user.\n  notifications        List all notifications.\n  octo                 Output an Easter egg or the given message from Octocat.\n  pull-request         Output detailed information about the given pull request.\n  pull-requests        List all pull requests.\n  rate-limit           Output the rate limit.  Not available for Enterprise.\n  repo                 Output detailed information about the given filter.\n  repos                List all repos matching the given filter.\n  search-issues        Search for all issues matching the given query.\n  search-repos         Search for all repos matching the given query.\n  starred              Output starred repos.\n  trending             List trending repos for the given language.\n  user                 List information about the given user.\n  view                 View the given index in the terminal or a browser.\n```\n\n## GitHub Integration Commands Reference: COMMANDS.md\n\nSee the [GitHub Integration Commands Reference in COMMANDS.md](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md) for a **detailed discussion** of all GitHub integration commands, parameters, options, and examples.\n\nCheck out the next section for a **quick reference**.\n\n## GitHub Integration Commands Quick Reference\n\n### Configuring `gitsome`\n\nTo properly integrate with GitHub, you must first configure `gitsome`:\n\n    $ gh configure\n\nFor GitHub Enterprise users, run with the `-e\u002F--enterprise` flag:\n\n    $ gh configure -e\n\n### Listing Feeds\n\n#### Listing Your News Feed\n\n    $ gh feed\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002F2LWcyS6.png)\n\n#### Listing A User's Activity Feed\n\nView your activity feed or another user's activity feed, optionally through a pager with `-p\u002F--pager`.  The [pager option](#option-view-in-a-pager) is available for many commands.\n\n    $ gh feed donnemartin -p\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FkryGLXz.png)\n\n#### Listing A Repo's Activity Feed\n\n    $ gh feed donnemartin\u002Fgitsome -p\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002Fd2kxDg9.png)\n\n### Listing Notifications\n\n    $ gh notifications\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FuwmwxsW.png)\n\n### Listing Pull Requests\n\nView all pull requests for your repos:\n\n    $ gh pull-requests\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002F4A2eYM9.png)\n\n### Filtering Issues\n\nView all open issues where you have been mentioned:\n\n    $ gh issues --issue_state open --issue_filter mentioned\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FAB5zxxo.png)\n\nView all issues, filtering for only those assigned to you, regardless of state (open, closed):\n\n    $ gh issues --issue_state all --issue_filter assigned\n\nFor more information about the filter and state qualifiers, visit the [`gh issues`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-issues) reference in [COMMANDS.md](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md).\n\n### Filtering Starred Repos\n\n    $ gh starred \"repo filter\"\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FJB88Kw8.png)\n\n### Searching Issues and Repos\n\n#### Searching Issues\n\nSearch issues that have the most +1s:\n\n    $ gh search-issues \"is:open is:issue sort:reactions-+1-desc\" -p\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FDXXxkBD.png)\n\nSearch issues that have the most comments:\n\n    $ gh search-issues \"is:open is:issue sort:comments-desc\" -p\n\nSearch issues with the \"help wanted\" tag:\n\n    $ gh search-issues \"is:open is:issue label:\\\"help wanted\\\"\" -p\n\nSearch issues that have your user name tagged **@donnemartin**:\n\n    $ gh search-issues \"is:issue donnemartin is:open\" -p\n\nSearch all your open private issues:\n\n    $ gh search-issues \"is:open is:issue is:private\" -p\n\nFor more information about the query qualifiers, visit the [searching issues reference](https:\u002F\u002Fhelp.github.com\u002Farticles\u002Fsearching-issues\u002F).\n\n#### Searching Repos\n\nSearch all Python repos created on or after 2015, with >= 1000 stars:\n\n    $ gh search-repos \"created:>=2015-01-01 stars:>=1000 language:python\" --sort stars -p\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FkazXWWY.png)\n\nFor more information about the query qualifiers, visit the [searching repos reference](https:\u002F\u002Fhelp.github.com\u002Farticles\u002Fsearching-repositories\u002F).\n\n### Listing Trending Repos and Devs\n\nView trending repos:\n\n    $ gh trending [language] [-w\u002F--weekly] [-m\u002F--monthly] [-d\u002F--devs] [-b\u002F--browser]\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002Faa1gOg7.png)\n\nView trending devs (devs are currently only supported in browser):\n\n    $ gh trending [language] --devs --browser\n\n### Viewing Content\n\n#### The `view` command\n\nView the previously listed notifications, pull requests, issues, repos, users etc, with HTML nicely formatted for your terminal, or optionally in your browser:\n\n    $ gh view [#] [-b\u002F--browser]\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FNVEwGbV.png)\n\n#### The `issue` command\n\nView an issue:\n\n    $ gh issue donnemartin\u002Fsaws\u002F1\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FZFv9MuV.png)\n\n#### The `pull-request` command\n\nView a pull request:\n\n    $ gh pull-request donnemartin\u002Fawesome-aws\u002F2\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002F3MtKjKy.png)\n\n### Setting Up `.gitignore`\n\nList all available `.gitignore` templates:\n\n    $ gh gitignore-templates\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002Fu8qYx1s.png)\n\nSet up your `.gitignore`:\n\n    $ gh gitignore-template Python > .gitignore\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FS5m5ZcO.png)\n\n### Setting Up `LICENSE`\n\nList all available `LICENSE` templates:\n\n    $ gh licenses\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FS9SbMLJ.png)\n\nSet up your  or `LICENSE`:\n\n    $ gh license MIT > LICENSE\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FzJHVxaA.png)\n\n### Summoning Octocat\n\nCall on Octocat to say the given message or an Easter egg:\n\n    $ gh octo [say]\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FbNzCa5p.png)\n\n### Viewing Profiles\n\n#### Viewing A User's Profile\n\n    $ gh user octocat\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FxVoVPVe.png)\n\n#### Viewing Your Profile\n\nView your profile with the `gh user [YOUR_USER_ID]` command or with the following shortcut:\n\n    $ gh me\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002Fcsk5j0S.png)\n\n### Creating Comments, Issues, and Repos\n\nCreate a comment:\n\n    $ gh create-comment donnemartin\u002Fgitsome\u002F1 -t \"hello world\"\n\nCreate an issue:\n\n    $ gh create-issue donnemartin\u002Fgitsome -t \"title\" -b \"body\"\n\nCreate a repo:\n\n    $ gh create-repo gitsome\n\n### Option: View in a Pager\n\nMany `gh` commands support a `-p\u002F--pager` option that displays results in a pager, where available.\n\nUsage:\n\n    $ gh \u003Ccommand> [param] [options] -p\n    $ gh \u003Ccommand> [param] [options] --pager\n\n### Option: View in a Browser\n\nMany `gh` commands support a `-b\u002F--browser` option that displays results in your default browser instead of your terminal.\n\nUsage:\n\n    $ gh \u003Ccommand> [param] [options] -b\n    $ gh \u003Ccommand> [param] [options] --browser\n\nSee the [COMMANDS.md](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md) for a detailed listing of all GitHub integration commands, parameters, options, and examples.\n\nHaving trouble remembering these commands?  Check out the handy [autocompleter with interactive help](#git-and-github-autocompleter-with-interactive-help) to guide you through each command.\n\n*Note, you can combine `gitsome` with other utilities such as [Git-Extras](https:\u002F\u002Fgithub.com\u002Ftj\u002Fgit-extras\u002Fblob\u002Fmaster\u002FCommands.md).*\n\n## Installation\n\n### Pip Installation\n\n[![PyPI version](https:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fgitsome.svg)](http:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fgitsome) [![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fpyversions\u002Fgitsome.svg)](https:\u002F\u002Fpypi.python.org\u002Fpypi\u002Fgitsome\u002F)\n\n`gitsome` is hosted on [PyPI](https:\u002F\u002Fpypi.python.org\u002Fpypi\u002Fgitsome).  The following command will install `gitsome`:\n\n    $ pip3 install gitsome\n\nYou can also install the latest `gitsome` from GitHub source which can contain changes not yet pushed to PyPI:\n\n    $ pip3 install git+https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome.git\n\nIf you are not installing in a `virtualenv`, you might need to run with `sudo`:\n\n    $ sudo pip3 install gitsome\n\n#### `pip3`\n\nDepending on your setup, you might also want to run `pip3` with the [`-H flag`](http:\u002F\u002Fstackoverflow.com\u002Fa\u002F28619739):\n\n    $ sudo -H pip3 install gitsome\n\nFor most linux users, `pip3` can be installed on your system using the `python3-pip` package.\n\nFor example, Ubuntu users can run:\n\n    $ sudo apt-get install python3-pip\n\nSee this [ticket](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fissues\u002F4) for more details.\n\n### Virtual Environment Installation\n\nYou can install Python packages in a [`virtualenv`](http:\u002F\u002Fdocs.python-guide.org\u002Fen\u002Flatest\u002Fdev\u002Fvirtualenvs\u002F) to avoid potential issues with dependencies or permissions.\n\nIf you are a Windows user or if you would like more details on `virtualenv`, check out this [guide](http:\u002F\u002Fdocs.python-guide.org\u002Fen\u002Flatest\u002Fdev\u002Fvirtualenvs\u002F).\n\nInstall `virtualenv` and `virtualenvwrapper`:\n\n    $ pip3 install virtualenv\n    $ pip3 install virtualenvwrapper\n    $ export WORKON_HOME=~\u002F.virtualenvs\n    $ source \u002Fusr\u002Flocal\u002Fbin\u002Fvirtualenvwrapper.sh\n\nCreate a `gitsome` `virtualenv` and install `gitsome`:\n\n    $ mkvirtualenv gitsome\n    $ pip3 install gitsome\n\nIf the `pip` install does not work, you might be running Python 2 by default.  Check what version of Python you are running:\n\n    $ python --version\n\nIf the call above results in Python 2, find the path for Python 3:\n\n    $ which python3  # Python 3 path for mkvirtualenv's --python option\n\nInstall Python 3 if needed.  Set the Python version when calling `mkvirtualenv`:\n\n    $ mkvirtualenv --python [Python 3 path from above] gitsome\n    $ pip3 install gitsome\n\nIf you want to activate the `gitsome` `virtualenv` again later, run:\n\n    $ workon gitsome\n\nTo deactivate the `gitsome` `virtualenv`, run:\n\n    $ deactivate\n\n### Running as a Docker Container\n\nYou can run gitsome in a Docker container to avoid installing Python and `pip3` locally. To install Docker check out the [official Docker documentation](https:\u002F\u002Fdocs.docker.com\u002Fengine\u002Fgetstarted\u002Fstep_one\u002F#step-1-get-docker).\n\nOnce you have docker installed you can run gitsome:\n\n    $ docker run -ti --rm mariolet\u002Fgitsome\n\nYou can use Docker volumes to let gitsome access your working directory, your local .gitsomeconfig and .gitconfig:\n\n    $ docker run -ti --rm -v $(pwd):\u002Fsrc\u002F              \\\n       -v ${HOME}\u002F.gitsomeconfig:\u002Froot\u002F.gitsomeconfig  \\\n       -v ${HOME}\u002F.gitconfig:\u002Froot\u002F.gitconfig          \\\n       mariolet\u002Fgitsome\n\nIf you are running this command often you will probably want to define an alias:\n\n    $ alias gitsome=\"docker run -ti --rm -v $(pwd):\u002Fsrc\u002F              \\\n                      -v ${HOME}\u002F.gitsomeconfig:\u002Froot\u002F.gitsomeconfig  \\\n                      -v ${HOME}\u002F.gitconfig:\u002Froot\u002F.gitconfig          \\\n                      mariolet\u002Fgitsome\"\n\nTo build the Docker image from sources:\n\n    $ git clone https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome.git\n    $ cd gitsome\n    $ docker build -t gitsome .\n\n### Starting the `gitsome` Shell\n\nOnce installed, run the optional `gitsome` autocompleter with interactive help:\n\n    $ gitsome\n\nRunning the optional `gitsome` shell will provide you with autocompletion, interactive help, fish-style suggestions, a Python REPL, etc.\n\n### Running `gh` Commands\n\nRun GitHub-integrated commands:\n\n    $ gh \u003Ccommand> [param] [options]\n\nNote: Running the `gitsome` shell is not required to execute `gh` commands.  After [installing](#installation) `gitsome` you can run `gh` commands from any shell.\n\n### Running the `gh configure` Command\n\nTo properly integrate with GitHub, `gitsome` must be properly configured:\n\n    $ gh configure\n\n#### For GitHub Enterprise Users\n\nRun with the `-e\u002F--enterprise` flag:\n\n    $ gh configure -e\n\nView more details in the [gh configure](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-configure) section.\n\n### Enabling Bash Completions\n\nBy default, `gitsome` looks at the following [locations to enable bash completions](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002Fxonsh\u002Fenviron.py#L123-L131).\n\nTo add additional bash completions, update the `~\u002F.xonshrc` file with the location of your bash completions.\n\nIf `~\u002F.xonshrc` does not exist, create it:\n\n    $ touch ~\u002F.xonshrc\n\nFor example, if additional completions are found in `\u002Fusr\u002Flocal\u002Fetc\u002Fmy_bash_completion.d\u002Fcompletion.bash`, add the following line in `~\u002F.xonshrc`:\n\n```\n$BASH_COMPLETIONS.append('\u002Fusr\u002Flocal\u002Fetc\u002Fmy_bash_completion.d\u002Fcompletion.bash')\n```\n\nYou will need to restart `gitsome` for the changes to take effect.\n\n### Enabling `gh` Tab Completions Outside of `gitsome`\n\nYou can run `gh` commands outside of the `gitsome` shell completer.  To enable `gh` tab completions for this workflow, copy the [`gh_complete.sh`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002Fscripts\u002Fgh_complete.sh) file locally.\n\nLet bash know completion is available for the `gh` command within your current session:\n\n    $ source \u002Fpath\u002Fto\u002Fgh_complete.sh\n\nTo enable tab completion for all terminal sessions, add the following to your `bashrc` file:\n\n    source \u002Fpath\u002Fto\u002Fgh_complete.sh\n\nReload your `bashrc`:\n\n    $ source ~\u002F.bashrc\n\nTip: `.` is the short form of `source`, so you can run this instead:\n\n    $ . ~\u002F.bashrc\n\n#### For Zsh Users\n\n`zsh` includes a module which is compatible with bash completions.\n\nDownload the [`gh_complete.sh`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002Fscripts\u002Fgh_complete.sh) file as above and append the following to your `.zshrc`:\n\n    autoload bashcompinit\n    bashcompinit\n    source \u002Fpath\u002Fto\u002Fgh_complete.sh\n\nReload your `zshrc`:\n\n     $ source ~\u002F.zshrc\n\n### Optional: Installing `PIL` or `Pillow`\n\nDisplaying the avatar for the `gh me` and `gh user` commands will require installing the optional `PIL` or `Pillow` dependency.\n\nWindows* and Mac:\n\n    $ pip3 install Pillow\n\n*See the [Windows Support](#windows-support) section for limitations on the avatar.\n\nUbuntu users, check out these [instructions on askubuntu](http:\u002F\u002Faskubuntu.com\u002Fa\u002F272095)\n\n### Supported Python Versions\n\n* Python 3.4\n* Python 3.5\n* Python 3.6\n* Python 3.7\n\n`gitsome` is powered by `xonsh` which does not currently support Python 2.x, as discussed in this [ticket](https:\u002F\u002Fgithub.com\u002Fscopatz\u002Fxonsh\u002Fissues\u002F66).\n\n### Supported Platforms\n\n* Mac OS X\n    * Tested on OS X 10.10\n* Linux, Unix\n    * Tested on Ubuntu 14.04 LTS\n* Windows\n    * Tested on Windows 10\n\n### Windows Support\n\n`gitsome` has been tested on Windows 10 with `cmd` and `cmder`.\n\nAlthough you can use the standard Windows command prompt, you'll probably have a better experience with either [cmder](https:\u002F\u002Fgithub.com\u002Fcmderdev\u002Fcmder) or [conemu](https:\u002F\u002Fgithub.com\u002FMaximus5\u002FConEmu).\n\n![Imgur](http:\u002F\u002Fi.imgur.com\u002FA1VCsjV.png)\n\n#### Text Only Avatar\n\nThe commands [`gh user`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-user) and [`gh me`](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCOMMANDS.md#gh-me) will always have the `-t\u002F--text_avatar` flag enabled, since [`img2txt`](#credits) does not support the ansi avatar on Windows.\n\n#### Config File\n\nOn Windows, the `.gitsomeconfig ` file can be found in `%userprofile%`.  For example:\n\n    C:\\Users\\dmartin\\.gitsomeconfig\n\n## Developer Installation\n\nIf you're interested in contributing to `gitsome`, run the following commands:\n\n    $ git clone https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome.git\n    $ cd gitsome\n    $ pip3 install -e .\n    $ pip3 install -r requirements-dev.txt\n    $ gitsome\n    $ gh \u003Ccommand> [param] [options]\n\n#### `pip3`\n\nIf you get an error while installing saying that you need Python 3.4+, it could be because your `pip` command is configured for an older version of Python. To fix this issue, it is recommended to install `pip3`:\n\n    $ sudo apt-get install python3-pip\n\nSee this [ticket](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fissues\u002F4) for more details.\n\n### Continuous Integration\n\n[![Build Status](https:\u002F\u002Ftravis-ci.org\u002Fdonnemartin\u002Fgitsome.svg?branch=master)](https:\u002F\u002Ftravis-ci.org\u002Fdonnemartin\u002Fgitsome)\n\nContinuous integration details are available on [Travis CI](https:\u002F\u002Ftravis-ci.org\u002Fdonnemartin\u002Fgitsome).\n\n### Unit Tests and Code Coverage\n\nRun unit tests in your active Python environment:\n\n    $ python tests\u002Frun_tests.py\n\nRun unit tests with [tox](https:\u002F\u002Fpypi.python.org\u002Fpypi\u002Ftox) on multiple Python environments:\n\n    $ tox\n\n### Documentation\n\nSource code documentation will soon be available on [Readthedocs.org](https:\u002F\u002Freadthedocs.org\u002F).  Check out the [source docstrings](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002Fgitsome\u002Fgithubcli.py).\n\nRun the following to build the docs:\n\n    $ scripts\u002Fupdate_docs.sh\n\n## Contributing\n\nContributions are welcome!\n\nReview the [Contributing Guidelines](https:\u002F\u002Fgithub.com\u002Fdonnemartin\u002Fgitsome\u002Fblob\u002Fmaster\u002FCONTRIBUTING.md) for details on how to:\n\n* Submit issues\n* Submit pull requests\n\n## Credits\n\n* [click](https:\u002F\u002Fgithub.com\u002Fpallets\u002Fclick) by [mitsuhiko](https:\u002F\u002Fgithub.com\u002Fmitsuhiko)\n* [github_trends_rss](https:\u002F\u002Fgithub.com\u002Fryotarai\u002Fgithub_trends_rss) by [ryotarai](https:\u002F\u002Fgithub.com\u002Fryotarai)\n* [github3.py](https:\u002F\u002Fgithub.com\u002Fsigmavirus24\u002Fgithub3.py) by [sigmavirus24](https:\u002F\u002Fgithub.com\u002Fsigmavirus24)\n* [html2text](https:\u002F\u002Fgithub.com\u002Faaronsw\u002Fhtml2text) by [aaronsw](https:\u002F\u002Fgithub.com\u002Faaronsw)\n* [img2txt](https:\u002F\u002Fgithub.com\u002Fhit9\u002Fimg2txt) by [hit9](https:\u002F\u002Fgithub.com\u002Fhit9)\n* [python-prompt-toolkit](https:\u002F\u002Fgithub.com\u002Fjonathanslenders\u002Fpython-prompt-toolkit) by [jonathanslenders](https:\u002F\u002Fgithub.com\u002Fjonathanslenders)\n* [requests](https:\u002F\u002Fgithub.com\u002Fkennethreitz\u002Frequests) by [kennethreitz](https:\u002F\u002Fgithub.com\u002Fkennethreitz)\n* [xonsh](https:\u002F\u002Fgithub.com\u002Fscopatz\u002Fxonsh) by [scopatz](https:\u002F\u002Fgithub.com\u002Fscopatz)\n\n## Contact Info\n\nFeel free to contact me to discuss any issues, questions, or comments.\n\nMy contact info can be found on my [GitHub page](https:\u002F\u002Fgithub.com\u002Fdonnemartin).\n\n## License\n\n*I am providing code and resources in this repository to you under an open source license.  Because this is my personal repository, the license you receive to my code and resources is from me and not my employer (Facebook).*\n\n[![License](http:\u002F\u002Fimg.shields.io\u002F:license-apache-blue.svg)](http:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0.html)\n\n    Copyright 2016 Donne Martin\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","gitsome 是一个增强版的 Git 和 GitHub 命令行界面工具。它通过提供深度的 GitHub 集成、自动补全和交互式帮助功能，极大地提升了开发者的使用体验与工作效率。项目支持包括但不限于分支、标签等在内的 Git 命令自动补全，并且集成了 29 个专为终端设计的 GitHub 操作命令。此外，gitsome 还具备一般性的 shell 自动补全能力，涵盖文件路径、环境变量等多个方面。该工具非常适合需要频繁在本地及远程仓库间切换操作的开发者，尤其当他们希望减少记忆负担并提高编码速度时。基于 Python 开发，跨平台兼容性良好，适用于 Linux、macOS 和 Windows 系统。","2026-06-11 03:27:59","top_topic"]