{"id":13566306,"url":"https://github.com/mlange-42/git-graph","last_synced_at":"2025-05-14T14:07:57.142Z","repository":{"id":54890972,"uuid":"319462847","full_name":"mlange-42/git-graph","owner":"mlange-42","description":"Command line tool to show clear git graphs arranged for your branching model","archived":false,"fork":false,"pushed_at":"2025-04-18T10:07:41.000Z","size":229,"stargazers_count":688,"open_issues_count":30,"forks_count":25,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-28T10:07:15.232Z","etag":null,"topics":["command-line","command-line-tool","git","git-flow","git-graph","gitlab-flow","graph","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/mlange-42.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":"2020-12-07T22:40:35.000Z","updated_at":"2025-04-28T08:24:23.000Z","dependencies_parsed_at":"2024-01-15T19:44:08.544Z","dependency_job_id":"301f0d35-82f1-4260-bbce-30648542e0f5","html_url":"https://github.com/mlange-42/git-graph","commit_stats":{"total_commits":109,"total_committers":4,"mean_commits":27.25,"dds":0.02752293577981646,"last_synced_commit":"9bd54eb0aed6f108364bce9ad0bdff12077038fc"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlange-42%2Fgit-graph","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlange-42%2Fgit-graph/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlange-42%2Fgit-graph/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlange-42%2Fgit-graph/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlange-42","download_url":"https://codeload.github.com/mlange-42/git-graph/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254159212,"owners_count":22024558,"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":["command-line","command-line-tool","git","git-flow","git-graph","gitlab-flow","graph","rust"],"created_at":"2024-08-01T13:02:06.718Z","updated_at":"2025-05-14T14:07:57.121Z","avatar_url":"https://github.com/mlange-42.png","language":"Rust","readme":"# git-graph\n\n[![Tests](https://github.com/mlange-42/git-graph/actions/workflows/tests.yml/badge.svg)](https://github.com/mlange-42/git-graph/actions/workflows/tests.yml)\n[![GitHub](https://img.shields.io/badge/github-repo-blue?logo=github)](https://github.com/mlange-42/git-graph)\n[![Crate](https://img.shields.io/crates/v/git-graph.svg)](https://crates.io/crates/git-graph)\n[![MIT license](https://img.shields.io/github/license/mlange-42/git-graph)](https://github.com/mlange-42/git-graph/blob/master/LICENSE)\n\nA command line tool to visualize Git history graphs in a comprehensible way, following different branching models.\n\nThe image below shows an example using the [GitFlow](https://nvie.com/posts/a-successful-git-branching-model/) branching model for a comparison between graphs generated by git-graph (far left) versus other tools and Git clients. \n\n\u003e GitFlow was chosen for its complexity, while any other branching model is supported, including user-defined ones.\n\n![Graph comparison between tools](https://user-images.githubusercontent.com/44003176/103466403-36a81780-4d45-11eb-90cc-167d210d7a52.png)\n\nDecide for yourself which graph is the most comprehensible. :sunglasses:\n\nIf you want an **interactive Git terminal application**, see [**git-igitt**](https://github.com/mlange-42/git-igitt), which is based on git-graph.\n\n## Features\n\n* View structured graphs directly in the terminal\n* Pre-defined and custom branching models and coloring\n* Different styles, including ASCII-only (i.e. no \"special characters\")\n* Custom commit formatting, like with `git log --format=\"...\"`\n\n## Installation\n\n**Pre-compiled binaries**\n\n1. Download the [latest binaries](https://github.com/mlange-42/git-graph/releases) for your platform\n2. Unzip somewhere\n3. *Optional:* add directory `git-graph` to your `PATH` environmental variable\n\n**Using `cargo`**\n\nIn case you have [Rust](https://www.rust-lang.org/) installed, you can install with `cargo`:\n\n```\ncargo install git-graph\n```\n\n## Usage\n\n**For detailed information, see the [manual](docs/manual.md)**.\n\nFor basic usage, run the following command inside a Git repository's folder:\n\n```\ngit-graph\n```\n\n\u003e Note: git-graph needs to be on the PATH, or you need use the full path to git-graph:\n\u003e \n\u003e ```\n\u003e C:/path/to/git-graph/git-graph\n\u003e ```\n\n**Branching models**\n\nRun git-graph with a specific model, e.g. `simple`:\n\n```\ngit-graph --model simple\n```\n\nAlternatively, set the model for the current repository permanently:\n\n```\ngit-graph model simple\n```\n\n**Get help**\n\nFor the full CLI help describing all options, use:\n\n```\ngit-graph -h\ngit-graph --help\n```\n\nFor **styles** and commit **formatting**, see the [manual](docs/manual.md).\n\n## Custom branching models\n\nBranching models are configured using the files in `APP_DATA/git-graph/models`. \n\n* Windows: `C:\\Users\\\u003cuser\u003e\\AppData\\Roaming\\git-graph`\n* Linux: `~/.config/git-graph`\n* OSX: `~/Library/Application Support/git-graph`\n\nFile names of any `.toml` files in the `models` directory can be used in parameter `--model`, or via sub-command `model`. E.g., to use a branching model defined in `my-model.toml`, use:\n\n```\ngit-graph --model my-model\n```\n\n**For details on how to create your own branching models see the manual, section [Custom branching models](docs/manual.md#custom-branching-models).**\n\n## Limitations\n\n* Summaries of merge commits (i.e. 1st line of message) should not be modified! git-graph needs them to categorize merged branches.\n* Supports only the primary remote repository `origin`.\n* Does currently not support \"octopus merges\" (i.e. no more than 2 parents)\n* On Windows PowerShell, piping to file output does not work properly (changes encoding), so you may want to use the default Windows console instead\n\n## Contributing\n\nPlease report any issues and feature requests in the [issue tracker](https://github.com/mlange-42/git-graph/issues).\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n","funding_links":[],"categories":["Rust"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlange-42%2Fgit-graph","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlange-42%2Fgit-graph","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlange-42%2Fgit-graph/lists"}