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 workflow automation to keep branches in sync and reduce merge conflicts.
https://github.com/git-town/git-town

command-line git git-flow productivity workflow

Last synced: about 1 month ago
JSON representation

Git workflow automation to keep branches in sync and reduce merge conflicts.

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: 2024-04-13T02:06:46.000Z (7 months ago)
Last Synced: 2024-04-14T00:32:37.055Z (7 months ago)
Topics: command-line, git, git-flow, productivity, workflow
Language: Go
Homepage: https://www.git-town.com
Size: 41.8 MB
Stars: 2,332
Watchers: 32
Forks: 98
Open Issues: 112
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- 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:2024-11 star:2.6k 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

- [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/observe.html) - add commits to

  somebody else's feature branch

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

  else's feature branch without contributing to it

- [park](https://www.git-town.com/advanced-syncing#parked-branches) - stop

  syncing one of your feature branches

- [prototype](https://www.git-town.com/advanced-syncing#prototype-branches) -

  sync but don't push a branch

#### Dealing with errors

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

  Git Town command after having resolved conflicts

- [skip](https://www.git-town.com/commands/skip.html) - restart 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

#### Advanced development commands

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

  commits on feature branches down to a single commit

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

- [rename-branch](https://www.git-town.com/commands/rename-branch.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/quick-configuration.html) 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)