bash-tools-utils

small bash scripts to help my workflow day to day

requirements

• bash (...)
• fzf (...)
• jq (https://jqlang.org/download/)
• git (used only for git helpers)

Window terminal

• For faster start time :

  "C:/Program Files/Git/bin/bash.exe" --noprofile -i

• For faster ssh rendering : Use the powershell ssh implementation. Rendering is much faster

  alias ssh='/c/Windows/System32/OpenSSH/ssh.exe'

ZSH user :

Make the default sheel bash. Because zsh is not compatible with bash

# Source - https://stackoverflow.com/a
# Posted by larsks
# Retrieved 2026-01-23, License - CC BY-SA 3.0
exec bash

Command / How to use

Project Navigation Utilities

Utilities for managing and navigating frequently used projects.

Projects are stored in:

~/bash_projects.json

Example:

{
  "viridem": "/var/www/viridem",
  "website": "/var/www/website",
  "api": "/home/user/projects/api"
}

---

op

Interactive project selector.

Usage

op

Features

• Displays all registered projects through fzf.
• Changes the current shell directory to the selected project.

Example

op

Select:

viridem

Result:

cd /var/www/viridem

---

opv

Open a project and launch Neovim.

Usage

opv

Workflow

1. Select a project.
2. Change to the project directory.
3. Launch:

nvim .

---

add_project

Register a project.

Usage

add_project <name>
add_project <name> <path>

Examples

Add the current directory:

add_project viridem

Add a specific directory:

add_project api /home/user/projects/api

Result:

✓ Project 'api' → /home/user/projects/api

Notes

• Automatically creates ~/bash_projects.json if missing.
• Paths are normalized to absolute paths.
• Requires jq.

---

remove_project

Remove a registered project.

Usage

remove_project <name>

Example

remove_project api

Result:

🗑️ Removed project 'api'

Notes

• Requires jq.
• Automatically refreshes the in-memory project list.

---

opr

Interactive project removal.

Usage

opr

Workflow

1. Select a project from fzf.
2. Confirm deletion.
3. Remove the project entry from ~/bash_projects.json.

Example:

Delete project 'api'?
[y/N]

---

list_projects

Display all registered projects.

Usage

list_projects

Example Output

viridem -> /var/www/viridem
website -> /var/www/website
api -> /home/user/projects/api

---

refresh_projects

Reload projects from disk.

Usage

refresh_projects

Example Output

🔄 Reloading projects...
✅ Projects reloaded (12 entries)

Useful after manually editing:

~/bash_projects.json

---

go_to_project

Navigate directly to a project by name.

Usage

go_to_project <name>

Example

go_to_project viridem

Result:

cd /var/www/viridem

---

Requirements

jq

Used for adding and removing projects.

Ubuntu/Debian:

sudo apt install jq

Fedora:

sudo dnf install jq

macOS:

brew install jq

fzf

Used for interactive project selection.

Ubuntu/Debian:

sudo apt install fzf

macOS:

brew install fzf

---

Quick Start

Add your current project:

add_project viridem

Jump to a project:

op

Open a project in Neovim:

opv

Remove a project:

opr

Git Utilities

A collection of Git helper functions for branch creation, checkout, pulling, stash management, and repository cleanup.

create_branch_from_ticket

Create a Git branch from a Jira ticket number or Jira URL.

Usage

create_branch_from_ticket <ticket-number>
create_branch_from_ticket <jira-url>

create_branch_from_ticket -p <prefix> <ticket-number>
create_branch_from_ticket --prefix <prefix> <ticket-number>

create_branch_from_ticket -n <branch-name>
create_branch_from_ticket --name <branch-name>

Examples

Create a branch from ticket 12345 using the default prefix (BSP):

create_branch_from_ticket 12345

Result:

feature/BSP-12345

Create a branch using a custom prefix:

create_branch_from_ticket -p ABC 12345

Result:

feature/ABC-12345

Create a branch from a Jira URL:

create_branch_from_ticket https://jira.company.com/browse/BSP-12345

Create a branch without any ticket prefix:

create_branch_from_ticket -n my-custom-branch

Workflow

1. Fetches remote branches.

2. Detects existing branches containing the ticket number.

3. Allows:

   • Switching to an existing branch.
   • Creating a new branch.

4. Prompts for a base branch.

   • Prefers release/* and hotfix/* branches.

5. Prompts for branch type:

   • feature
   • bugfix

6. Optionally adds a suffix.

7. Creates and checks out the branch.

8. Offers to restore any stashed changes.

Generated Branch Format

feature/BSP-12345
feature/BSP-12345-v1
bugfix/BSP-12345-fix-validation

---

git_checkout

Interactive branch checkout.

Usage

git_checkout

Features

• Fetches local and remote branches.
• Displays all available branches through fzf.
• Checks out the selected branch.

Alias

gc

---

apply_stash

Interactive stash restoration helper.

Usage

apply_stash

Options

Allows you to:

• Show stash summary
• Show detailed patch
• Apply stash
• Skip stash restoration

Typical Flow

Show stash?
 ├─ yes
 │   ├─ Show details?
 │   └─ Apply stash?
 ├─ apply
 └─ skip

---

git_stash_show

Shortcut for opening the stash recovery workflow.

Usage

git_stash_show

---

gclean

Delete local branches whose remote counterparts no longer exist.

Usage

gclean

Equivalent To

git fetch -p

git branch -vv \
| grep ': gone]' \
| awk '{print $1}' \
| xargs git branch -D

Example

Before:

feature/BSP-1001
feature/BSP-1002
feature/BSP-1003

After remote cleanup:

gclean

Deleted:

feature/BSP-1002
feature/BSP-1003

---

For a README, I'd keep this one short since it's a single-purpose utility.

---

Bitbucket Utilities

Helpers for creating Bitbucket pull requests directly from the command line.

---

pr

Alias for pra.

Usage

pr

---

pra

Create a Bitbucket Pull Request URL for the current branch.

Usage

pra

Workflow

1. Prompts for the destination branch.

2. Detects:

   • Current Git repository
   • Repository owner/workspace
   • Repository name
   • Current branch

3. Builds a Bitbucket Pull Request URL.

4. Opens the URL in your browser.

Example

Current branch:

feature/BSP-12345-fix-validation

Selected destination branch:

release/2026.06

Generated URL:

https://bitbucket.org/company/my-repo/pull-requests/new?source=feature/BSP-12345-fix-validation&dest=release/2026.06

The browser opens directly on Bitbucket's Create Pull Request page with the source and destination branches already populated.

---

Requirements

Git Remote

The repository must have an origin remote configured:

git remote -v

Example:

origin  git@bitbucket.org:company/my-repo.git

or

origin  https://bitbucket.org/company/my-repo.git

Base Branch Selector

This command relies on:

git_select_base_branch

to choose the target branch for the pull request.

---

Typical Workflow

# Create a feature branch
create_branch_from_ticket 12345

# Work on your changes
git add .
git commit

# Push branch
git push -u origin HEAD

# Create pull request
pr

Benefits

• No need to manually navigate to Bitbucket.
• Automatically detects the current branch.
• Reduces mistakes when selecting source/destination branches.
• Integrates with the branch-selection workflow already used by other Git utilities.

Todos

• Add spinner program
• add spinner for thing taht take time. like fetching
• Add protection
  • Git (if not installed.)
  • ... jq