https://github.com/viqueen/git-workspaces

Collection of git extensions to enhance my local development setup
https://github.com/viqueen/git-workspaces

developer-tools git hacktoberfest hacktoberfest2022

Last synced: 9 months ago
JSON representation

Collection of git extensions to enhance my local development setup

• Host: GitHub
• URL: https://github.com/viqueen/git-workspaces
• Owner: viqueen
• License: apache-2.0
• Created: 2022-10-14T05:31:11.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-08-26T05:12:33.000Z (10 months ago)
• Last Synced: 2025-08-26T07:10:35.694Z (10 months ago)
• Topics: developer-tools, git, hacktoberfest, hacktoberfest2022
• Language: TypeScript
• Homepage:
• Size: 1.52 MB
• Stars: 2
• Watchers: 1
• Forks: 1
• Open Issues: 20
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
## git-workspaces

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=viqueen_git-devbox&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=viqueen_git-devbox)

[![Known Vulnerabilities](https://snyk.io/test/github/viqueen/git-devbox/badge.svg?targetFile=package.json)](https://snyk.io/test/github/viqueen/git-devbox?targetFile=package.json)

### install it

#### from stable

- with **homebrew** (preferred)

```bash

brew tap viqueen/labset

brew install git-workspaces

```

- with **npm** (not recommended)

```bash

npm install @labset/git-workspaces -g

```

#### from source

```bash

git clone https://github.com/viqueen/git-workspaces.git

cd git-workspace

npm install

npm link

```

### use it

#### working with branches

- list recent git branches that you've interacted with locally, select one to check it out

```bash

git recent

```

![git recent example](./docs/images/git-recent.png)

- list merged git branches that you still have locally, multi select the ones you want to delete

```bash

git merged

git merged origin/master

```

![git merged example](./docs/images/git-merged.png)

- list squashed git branches that you still have locally, multi select the ones you want to delete

```bash

git squashed

git squashed origin/master

```

- list recent branches that you've interacted with, multi select the ones you want to delete

```bash

git tidy

```

#### setup git workspaces

- start by some configuration

```bash

git workspace-config

```

it will add the following git global config entries

```text

git.workspaces.root                     # where you want all your workspaces to be

git.workspaces.default                  # your default workspace, i.e open-source vs work

git.workspaces.github.username          # your github username

git.workspaces.github.personal.token    # your github personal access token

```

- add a repo to your workspace

```bash

git workspace-add          # adds to default workspace

git workspace-add  -w   # adds to workspace with provided name

```

- view your workspace

```bash

git workspace             # describes default workspace

git workspace -w    # describes workspace with provided name

```

- clone your entire workspace

```bash

git workspace-clone

git workspace-clone -w 

```

- sync workspace with GitHub, it requires GitHub username and token to be set when working with private repos

```bash

git sync-github                               # logged in user repos

git sync-github --user 

git sync-github --org 

git sync-github --org  --archived  # include archived

git sync-github --user  --forked   # include forked

```

- sync workspace with Bitbucket Cloud, it requires Bitbucket username and token to be configured

```bash

git sync-bitbucket --namespace 

```

- execute a script across your git workspace

```bash

git workspace-exec  [args...]

```