qork // command-line clientv1.0.0

qork

Shorten URLs from your terminal.

01 // Install

One line, any platform

No account required. The installer drops a single static binary on your PATH.

Install

$ curl -LsSf https://qork.me/install.sh | sh

Recommended on macOS & Linux. Downloads a prebuilt binary for your CPU (Intel or ARM) to ~/.cargo/bin — no Rust/cargo, no admin.

02 // Usage

Pass a URL, get a link

qork prints the short URL to stdout — pipe it, copy it, script it.

QORK // SAMPLE SESSIONSHELL: ~

qork https://example.com/some/very/long/path

https://qork.me/ka9m

qork "https://example.com/a b?x=1&y=2"

https://qork.me/pu3n

qork https://example.com --alias launch

https://qork.me/launch

qork --json https://example.com

{ "shortUrl": "qork.me/ka9m", "isNew": true }

Quote URLs that contain spaces or shell metacharacters (&, ?) so your shell hands the whole string to qork intact.

Before shortening, qork checks the link is real — it won't shorten pasted text or a dead (404) URL. Pass --no-check to skip that.

Command	Description
`qork <url>`	Shorten a URL; prints the short link
`qork <url> --alias <name>`	Use a custom short code
`qork <url> --json`	Print the raw JSON (scripts/agents)
`qork <url> --no-check`	Skip the live-link safety check
`qork help`	Show help and documentation
`qork update`	Update to the latest release (per install method)
`qork uninstall [--yes]`	Fully remove qork from this system
`qork --version`	Print the version

Run qork --help for the full command reference.

03 // Installers

Native installers

Prefer a download? Grab a native installer for your platform. On macOS and Linux the command-line install above is the recommended path; on Windows the MSI/EXE installers work best.

Windows

qork-x86_64-pc-windows-msvc.msi

Global · MSI

Per-machine install to Program Files. Requires administrator.

Download

qork-x86_64-pc-windows-msvc-setup.exe

Global · EXE

Per-machine Setup wizard. Requires administrator.

Download

qork-x86_64-pc-windows-msvc-corporate.msi

Corporate · MSI

Per-user install to %LocalAppData%. No admin needed.

Download

qork-x86_64-pc-windows-msvc-corporate-setup.exe

Corporate · EXE

Per-user Setup wizard. No admin needed.

Download

macOS · the curl install above is recommended

qork-aarch64-apple-darwin.pkg

Apple Silicon (M1+)

Unsigned .pkg — first run: right-click → Open.

Download .pkg

qork-x86_64-apple-darwin.pkg

Intel

Unsigned .pkg — first run: right-click → Open.

Download .pkg

Linux · the curl install above is recommended

qork-x86_64-unknown-linux-gnu.deb

Debian / Ubuntu · x86_64

Installs to /usr/bin. sudo apt install ./<file>

Download

qork-x86_64-unknown-linux-gnu.rpm

Fedora / RHEL · x86_64

Installs to /usr/bin. sudo dnf install ./<file>

Download

qork-aarch64-unknown-linux-gnu.deb

Debian / Ubuntu · ARM64

Installs to /usr/bin. sudo apt install ./<file>

Download

qork-aarch64-unknown-linux-gnu.rpm

Fedora / RHEL · ARM64

Installs to /usr/bin. sudo dnf install ./<file>

Download

All release assets & raw binaries crates.io / qork

04 // API

For agents

The same shortener behind a plain HTTP endpoint — no key, no SDK.

Both GET and POST hit https://qork.me/api/shorten and return the same JSON. Ideal for pipelines and autonomous agents that need a clean link.

QORK // APIPOST · GET

# GET

curl "https://qork.me/api/shorten?url=https%3A%2F%2Fexample.com"

# POST

curl -X POST https://qork.me/api/shorten \

-H "Content-Type: application/json" \

-d '{"url":"https://example.com","source":"api"}'

Response

{
  "shortCode": "ka9m",
  "shortUrl": "qork.me/ka9m",
  "href": "https://qork.me/ka9m",
  "longUrl": "https://example.com",
  "isNew": true
}

Full agent guide: qork.me/llms.txt(opens in a new tab)