Zing 🚀

Zing helps developers zing through repetitive commands.

---

🧠 One-liner

Automate your most frequent CLI workflows with human-friendly aliases, templates, and project-aware suggestions — stay in flow and ship faster.

---

💡 Why Zing?

• Kill repetition: Turn 120-character shell incantations into zing deploy prod.
• Stay consistent: Share the same commands across your team and CI.
• Project-aware: Zing detects tech stacks (Node, Go, Docker, K8s) and suggests relevant tasks.
• Portable: Works across macOS, Linux, and Windows (WSL).

---

⚙️ Key Features

• Aliases & templates: Parameterized commands with variables and prompts.
• Workflows: Chain multiple steps with error handling and conditional logic.
• Context detection: Autoloads .zing.yml in a repo; global fallbacks in ~/.zing.
• Dry-run & preview: See exactly what will execute before it runs.
• History & re-run: Fuzzy search your last used tasks.
• Shell-native: Works in bash/zsh/fish/PowerShell; autocompletion included.

---

🚀 Quick Start

Install (Go example)

• MacOS

brew tap zing https://github.com/chuksgpfr/zing
brew install --cask zing

• Go

go install github.com/chuksgpfr/zing

Running on macOS (Gatekeeper notice)

On macOS, you might see a warning like:

"Apple cannot verify that 'zing' is free of malware"

This happens because zing is a custom CLI tool and not distributed via the Mac App Store.
If you downloaded zing from a trusted source (e.g. this GitHub repo), you can allow it:

1. Try to run zing once so macOS shows the warning.
2. Open System Settings → Privacy & Security.
3. Scroll down until you see a message saying that "zing was blocked".
4. Click "Allow Anyway", then run zing again and choose "Open".

Alternatively, from the terminal you can remove the quarantine flag:

xattr -d com.apple.quarantine /usr/local/bin/zing

check version

zing version

Add a task interactively

zing add --tag "deploy" --cmd "docker compose build && docker compose push && kubectl rollout restart deploy/<variable1> -n <variable2>"

Run it (with prompts for variables)

zing run deploy variable1=kha variable2=gan

CLI Cheatsheet

zing add --tag <name> ----cmd "<command>"   # add/append a task interactively
zing run <name> [args]    # run a task or workflow
zing list                 # list tasks with descriptions
zing preview <name>       # render command with variables (no exec)
zing suggest              # generate project-aware task suggestions (Coming Soon)