swk

swk — Developer's Swiss Army Knife

A CLI toolkit for everyday developer tasks.

Install

Quick install

curl -sL https://raw.githubusercontent.com/agejevasv/swk/main/install.sh | sh

Or specify a directory:

SWK_INSTALL_DIR=~/.local/bin curl -sL https://raw.githubusercontent.com/agejevasv/swk/main/install.sh | sh

From source

git clone https://github.com/agejevasv/swk.git
cd swk
make build

Shell completion

# Bash
swk completion bash > /etc/bash_completion.d/swk

# Zsh
swk completion zsh > "${fpath[1]}/_swk"

# Fish
swk completion fish > ~/.config/fish/completions/swk.fish

Usage

swk <category> <command> [file|input] [flags]

Every command reads from stdin when no argument is given, writes to stdout, and sends errors to stderr. Document-oriented commands (json, xml, markdown, hash, etc.) accept a file path as the argument — if the file exists, its contents are read automatically. Use - to explicitly read stdin.

# These are equivalent:
cat data.json | swk format json
swk format json data.json
swk format json - < data.json

Commands

Convert (swk convert, swk c)

# Number base conversion
swk convert base 255 --from dec --to hex

# Byte sizes (default: 1024-based with IEC labels)
swk convert bytes 1073741824           # 1 GiB
swk convert bytes '1.5GiB'            # 1610612736
swk convert bytes -d 1000000000        # 1 GB (decimal, 1000-based)
swk convert bytes '1.5GB'             # 1500000000

# Case conversion
echo 'helloWorld' | swk convert case --to snake    # hello_world
echo 'hello world' | swk convert case --to camel   # helloWorld

# File permissions
swk convert chmod 755                  # shows rwxr-xr-x + breakdown
swk convert chmod rwxr-xr-x           # shows 755 + breakdown
swk convert chmod 4755                 # setuid support

# Color format conversion
swk convert color '#FF5733'
swk convert color '255,87,51' --from rgb --to hex

# Date/time conversion
swk convert date 1700000000 --from unix --to iso
swk convert date 1700000000 --from unix --to human --tz UTC
swk convert date now --to unix
swk convert date 1700000000 --from unix --to '%Y-%m-%d' --tz UTC   # 2023-11-14
swk convert date '2023-11-14' --from '%Y-%m-%d' --to unix

# Duration conversion
swk convert duration 86400             # 1d
swk convert duration '2d 5h 30m'      # 192600
swk convert duration 31536000          # 1y
swk convert duration '1y 6mo'         # 47088000

# Image conversion (accepts file path)
swk convert image photo.png --to jpeg -o photo.jpg
swk convert image large.png --to png --resize 200x200 -o thumb.png

# JSON to YAML
echo '{"name":"swk"}' | swk convert json2yaml
swk convert json2yaml data.json

# YAML to JSON
echo 'name: swk' | swk convert yaml2json
swk convert yaml2json config.yaml

# JSON to CSV
echo '[{"name":"alice","age":30}]' | swk convert json2csv

# CSV to JSON
printf 'name,age\nalice,30\n' | swk convert csv2json

# Render markdown (accepts file path)
swk convert markdown README.md --html > preview.html
swk convert markdown README.md --html --syntax-highlight > highlighted.html

Format (swk format, swk fmt, swk f)

# JSON prettify/minify (accepts file path)
swk format json data.json
swk format json config.json --minify
swk format json data.json --indent 4

# XML format (accepts file path)
swk format xml messy.xml
swk format xml document.xml --minify

# JSON array as table
echo '[{"name":"alice","age":30},{"name":"bob","age":25}]' | swk format json2table
echo '[{"name":"alice"}]' | swk format json2table --style simple

# CSV as table
printf 'name,age\nalice,30\n' | swk format csv2table

# Extract nested array, then render as table
echo '{"meta":"v1","users":[{"name":"alice"},{"name":"bob"}]}' \
  | swk query json '$.users' \
  | swk format json2table

Encode (swk encode, swk enc)

# Base64
echo 'hello world' | swk encode base64
echo 'aGVsbG8gd29ybGQ=' | swk encode base64 -d
echo 'data' | swk encode base64 --url-safe

# Hash (accepts file path)
swk encode hash README.md
swk encode hash README.md --algo md5
echo -n 'hello' | swk encode hash --verify 2cf24dba...

# JWT — create with HMAC
swk encode jwt --secret mykey '{"sub":"user1","role":"admin"}'

# JWT — create with RSA/EC/Ed25519
swk encode jwt --algo RS256 --key private.pem '{"sub":"user1"}'
swk encode jwt --algo ES256 --key ec-private.pem '{"sub":"user1"}'

# JWT — decode (no verification, works with any algorithm)
swk encode jwt -d 'eyJhbGciOiJIUzI1NiIs...'

# JWT — verify with HMAC secret
swk encode jwt -d --secret mykey 'eyJhbGciOiJIUzI1NiIs...'

# JWT — verify with public key (RSA/EC/Ed25519)
swk encode jwt -d --key public.pem 'eyJhbGciOiJSUzI1NiIs...'

# QR code
swk encode qr 'https://github.com/agejevasv/swk'
swk encode qr --output png 'https://example.com' > qr.png

Escape (swk escape, swk esc)

# HTML
echo '<script>alert("xss")</script>' | swk escape html
echo '&lt;div&gt;' | swk escape html -u

# JSON
echo 'line1\nline2' | swk escape json
echo '\"hello\"' | swk escape json -u

# Shell
echo "it's a test" | swk escape shell

# URL
echo 'hello world & friends' | swk escape url
echo 'hello%20world' | swk escape url -u

# XML
echo '<tag attr="val">' | swk escape xml

Generate (swk generate, swk g)

# Placeholder image
swk generate image -o placeholder.png
swk generate image --style circles --width 1920 --height 1080 -o wallpaper.png

# Passwords
swk generate password
swk generate password --length 32 --no-symbols
swk generate password --count 10

# Lorem ipsum
swk generate text --paragraphs 3
swk generate text --words 50

# UUIDs
swk generate uuid
swk generate uuid --count 5
swk generate uuid --version 7

Inspect (swk inspect, swk i)

# Certificate (accepts file path)
swk inspect cert cert.pem
swk inspect cert cert.pem --check-expiry

# Cron
swk inspect cron '*/5 * * * *'
swk inspect cron --explain '0 9 * * 1-5'
swk inspect cron --next 3 '0 9 * * MON'

# Text stats (accepts file path)
swk inspect text essay.txt
echo 'hello world' | swk inspect text --json

# URL parsing
swk inspect url 'https://example.com:8080/api/v1/users?page=1&limit=10#section'

Query (swk query, swk q)

# HTML (CSS selectors — accepts file path)
curl -s https://example.com | swk query html 'a' --attr href
swk query html 'div.content p' page.html

# JSON (JSONPath — accepts file path)
swk query json '$.users[*].name' data.json

# Regex (pattern is first argument — accepts file path)
echo '2024-01-15 hello 2024-02-20' | swk query regex -o -g '\d{4}-\d{2}-\d{2}'
echo 'John:30' | swk query regex --groups '(\w+):(\d+)'
echo 'foo bar baz' | swk query regex -r 'qux' 'bar'

Piping and chaining

Every command reads stdin and writes stdout:

# JSON → format → base64
echo '{"a":1}' | swk format json | swk encode base64

# Generate password → display on stderr, hash to stdout
swk generate password | tee /dev/stderr | swk encode hash

# YAML → JSON → minify → clipboard (macOS)
cat config.yaml | swk convert yaml2json | swk format json -m | pbcopy

# Fetch API → format as table
curl -s https://api.example.com/users | swk format json2table

# Extract nested array → table
echo '{"status":"ok","items":[{"id":1,"name":"foo"},{"id":2,"name":"bar"}]}' \
  | swk query json '$.items' \
  | swk format json2table

# Duration roundtrip
swk convert duration '2d 5h' --to seconds | swk convert duration --to human

# CSV → JSON → query with JSONPath
swk convert csv2json data.csv | swk query json '$..[?(@.age>30)]'

# Scrape links from a webpage
curl -s https://example.com | swk query html 'a' --attr href

Testing

make test          # run all tests
make test-verbose  # run with verbose output
make lint          # run go vet + staticcheck

License

MIT