Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/git-town/git-town

Git branches made easy
https://github.com/git-town/git-town

command-line git git-flow productivity workflow

Last synced: 1 day ago
JSON representation

Git branches made easy

Host: GitHub
URL: https://github.com/git-town/git-town
Owner: git-town
License: mit
Created: 2014-05-15T15:44:29.000Z (over 10 years ago)
Default Branch: main
Last Pushed: 2025-01-14T04:04:27.000Z (12 days ago)
Last Synced: 2025-01-19T20:42:03.002Z (7 days ago)
Topics: command-line, git, git-flow, productivity, workflow
Language: Go
Homepage: https://www.git-town.com
Size: 48.5 MB
Stars: 2,691
Watchers: 34
Forks: 111
Open Issues: 30
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

awesome-github-repos - git-town/git-town - Git branches made easy (Go)
jimsghstars - git-town/git-town - Git branches made easy (Go)
my-awesome - git-town/git-town - line,git,git-flow,productivity,workflow pushed_at:2025-01 star:2.7k fork:0.1k Git branches made easy (Go)

README

        


  

    

    

    

  

  


  

  

  

  

  

  



Git Town provides additional Git commands that automate the creation,

synchronization, shipping, and cleanup of Git branches. Compatible with all

popular Git workflows like Git Flow, GitHub Flow, GitLab Flow, and trunk-based

development. Supports mono-repos and stacked changes. Check out

[this screencast](https://youtu.be/oLaUsUlFfTo) for an introduction.

#### Basic development commands

- [hack](https://www.git-town.com/commands/hack.html) - create a new up-to-date

  feature branch off the main branch

- [sync](https://www.git-town.com/commands/sync.html) - update existing

  branches, remove shipped branches

- [switch](https://www.git-town.com/commands/switch.html) - switch between

  branches via text UI

- [propose](https://www.git-town.com/commands/propose.html) - create a pull or

  merge request for a feature branch

#### Stacked changes

- [append](https://www.git-town.com/commands/append.html) - insert a new branch

  as a child of the current branch

- [diff-parent](https://www.git-town.com/commands/diff-parent.html) - show the

  changes committed to a feature branch

- [merge](https://www.git-town.com/commands/merge.html) - merge two adjacent

  branches in a stack into one

- [prepend](https://www.git-town.com/commands/prepend.html) - insert a new

  branch between the current branch and its parent

- [set-parent](https://www.git-town.com/commands/set-parent.html) - update the

  parent of a branch

#### Limit branch syncing

- [contribute](https://www.git-town.com/commands/contribute) - add commits to

  somebody else's feature branch

- [observe](https://www.git-town.com/commands/observe) - track somebody else's

  feature branch without contributing to it

- [park](https://www.git-town.com/commands/park) - stop syncing one of your

  feature branches

- [prototype](https://www.git-town.com/commands/prototype) - sync but don't push

  a branch

#### Dealing with errors

- [continue](https://www.git-town.com/commands/continue.html) - resume the last

  run Git Town command after having resolved conflicts

- [skip](https://www.git-town.com/commands/skip.html) - resume the last run Git

  Town command by skipping the current branch

- [status](https://www.git-town.com/commands/status.html) - displays or resets

  the current suspended Git Town command

- [undo](https://www.git-town.com/commands/undo.html) - undo the most recent Git

  Town command

#### Setup and configuration

- [config](https://www.git-town.com/commands/config.html) - display or update

  your Git Town configuration

- [config setup](https://www.git-town.com/commands/config-setup) - run the

  visual setup assistant

- [offline](https://www.git-town.com/commands/offline.html) - start or stop

  running in offline mode

- [completions](https://www.git-town.com/commands/completions) -

  auto-completions for bash, zsh, fish, and PowerShell

#### Advanced development commands

- [branch](https://www.git-town.com/commands/branch) - display the local branch

  hierarchy

- [compress](https://www.git-town.com/commands/compress.html) - squash all

  commits on feature branches down to a single commit

- [delete](https://www.git-town.com/commands/delete.html) - remove a feature

  branch

- [rename](https://www.git-town.com/commands/rename.html) - rename a branch

- [repo](https://www.git-town.com/commands/repo.html) - view the repository

  homepage

- [ship](https://www.git-town.com/commands/ship.html) - merge a completed

  feature branch and remove it

## Installation

See the [installation](https://www.git-town.com/install.html) and

[configuration](https://www.git-town.com/configuration) instructions.

## Documentation

The [Git Town website](https://www.git-town.com) provides documentation for Git

Town users. `git town help [command]` shows help on the CLI.

## Contributing

Found a bug or have an idea for a new feature?

[Open an issue](https://github.com/git-town/git-town/issues/new) or send a

[pull request](https://help.github.com/articles/using-pull-requests)! Our

[developer documentation](docs/DEVELOPMENT.md) helps you get started.

[![Stargazers over time](https://starchart.cc/git-town/git-town.svg)](https://starchart.cc/git-town/git-town)