jz-tools

Personal CLI tools for local development workflows.

Install

bun -g add @jimzord12/jz-tools
# or
npm i -g @jimzord12/jz-tools

Usage

jz-tools --help
jz-tools docs            # Print full reference (AI-friendly)

git rename-branch

Rename a Git branch locally and on the remote.

jz-tools git rename-branch <old> <new> [options]

| Option | Description | Default | |---|---|---| | -r, --remote <name> | Remote name | origin | | -b, --base <branch> | Base branch for team-update instructions | main | | --dry-run | Print git commands without executing | — |

jz-tools git rename-branch old-feature new-feature
jz-tools git rename-branch old-feature new-feature --dry-run

img crop

Crop an image by removing pixels from one or more sides.

jz-tools img crop <image> [options]

| Option | Description | |---|---| | -t, --top <amount> | Amount to crop from top | | -b, --bottom <amount> | Amount to crop from bottom | | -l, --left <amount> | Amount to crop from left | | -r, --right <amount> | Amount to crop from right | | -o, --output <path> | Output file path (default: <name>-cropped.<ext>) |

Amounts accept pixels (50, 50px) or percentages (10%).

jz-tools img crop photo.png --bottom 25%
jz-tools img crop photo.png --top 50 --bottom 50
jz-tools img crop photo.png --left 10% --right 10% --output trimmed.png

Programmatic API

import { renameGitBranch, cropImage } from '@jimzord12/jz-tools';

Both functions accept injected clients for testing.

License

MIT