Shell productivity toolkit for developers

Stop typing long commands. Automate Git workflows, manage Docker/K8s, connect to AWS with 200+ aliases. Shell automation for Bash & Zsh on macOS, Linux, WSL.

Install

Choose your preferred method. Requires Bash 4+ or Zsh, and Git. After install, restart your terminal and run cbash to see the help.

brew install cminhho/tap/cbash-cli
sh -c "$(curl -fsSL https://raw.githubusercontent.com/cminhho/cbash/master/tools/install.sh)"
sh -c "$(wget -qO- https://raw.githubusercontent.com/cminhho/cbash/master/tools/install.sh)"

Features

Complete shell automation suite. Git workflow automation, Docker management, Kubernetes tools, AWS integration, and 200+ productivity aliases.

πŸš€ Setup

Dev environment checker, Homebrew tool installer (dev/cloud/IDE/apps), workspace scaffolding. One-command setup for new machines.

πŸ”€ Git Automation

Multi-repo operations, auto-commit/push, branch management, interactive squash, batch operations. Git workflow automation with 50+ aliases.

🐳 Docker Tools

Docker Compose management, container operations, log following, resource monitoring. 30+ Docker aliases for dev workflow automation.

☁️ AWS Integration

SSM Session Manager SSH, SQS operations, parameter store access. AWS CLI productivity tools for cloud developers.

☸️ Kubernetes

Pod management, log streaming, shell access, deployment rollouts. Kubectl productivity tools with built-in cheat sheet.

πŸ“ Generators

Project scaffolding, workspace templates, document generators, troubleshooting helpers. CLI templates for rapid development.

πŸ“š Knowledge Base

Terminal-accessible docs, cheatsheets, quick references. Community-driven knowledge sharing with cheat integration.

πŸ€– AI Assistant

Local AI chat via Ollama, model management, terminal-based AI assistance. Quick AI help without leaving your workflow.

βš™οΈ System Tools

macOS utilities, network tools, proxy management, password generation, file operations. System administration productivity tools.

Usage

Commands are plugin-based. Run cbash or cbash help for the full reference; cbash <plugin> help for plugin-specific help.

cbash                  # Show main help
cbash <plugin>         # Run a plugin (e.g. git, dev, aws, k8s)
cbash list-plugins     # List all available plugins

Running cbash prints the minimal help. Use cbash --full for all commands:

cbash
CBASH CLI (1.0) – macOS command line tools for developers

USAGE
  cbash [COMMAND] [SUBCOMMAND] [OPTIONS]

GIT
  git auto-commit                       Auto commit and push β†’ commit
  git auto-squash                       Squash feature branch β†’ auto_squash
  git pull-all           [dir]          Pull all repos β†’ pull_all
  git clone-all          <file>         Clone repos from file β†’ clone_all
  git for                "<cmd>"        Run command in all repos β†’ gitfor

DEVELOPMENT
  dev start              [svc]          Start Docker services β†’ start
  dev stop               [svc]          Stop services β†’ stop
  dev logs               [svc]          Follow logs β†’ devlogs
  dev exec               <svc>          Shell into service β†’ devexec
  dev kill-all                          Stop and remove all β†’ devkill

K8S
  k8s pods               [opts]         List pods β†’ k8pods
  k8s logs               <pod>          Follow pod logs β†’ k8logs
  k8s exec               <pod>          Shell into pod β†’ k8exec
  k8s restart            <deploy>       Rollout restart β†’ k8restart

AWS
  aws ssh                <profile>      Connect via SSM β†’ awsssh
  aws ssm-get                           Get SSM parameter β†’ awsssmget

MORE
  ai chat                [model]        Chat with AI (Ollama) β†’ chat
  docs cheat             <name>         View cheatsheet β†’ ch
  macos ports                           List listening ports β†’ mports
  proxy enable           [url]          Enable proxy β†’ proxon

Run cbash --full for all commands, or cbash <plugin> help for plugin help.

Why CBASH?

Save hours daily. Stop typing repetitive commands. Focus on code, not shell.

Task Without CBASH With CBASH
Clone repos from list Manual clone each clone_all repos.txt
Pull all repos for d in */; do cd "$d" && git pull && cd ..; done pull_all
Run cmd in all repos Loop + cd + eval gitfor "git status"
Auto-commit & push git add . && git commit -m "..." && git push commit
Squash feature branch Interactive rebase, force push auto_squash

Popular Aliases

200+ aliases included. Here are the most used ones:

Alias Description
commitAuto-commit with timestamp
pull_allPull all repos in directory
clone_allClone repos from file
gitforRun cmd in all repos
start / stopDocker Compose services
devlogsFollow container logs
k8podsList Kubernetes pods
k8logsFollow pod logs
awssshSSM Session Manager
chatChat with Ollama AI
chView cheatsheet
mportsList listening ports

Support the project

GitHub Sponsors Buy Me A Coffee