byk
A CLI that only runs aliases
Write commands into *.byk.json, and call them by short names
$ byk @@hi..init
Created ~/.byk/alias/hi.byk.json
$ byk @@hi..set hello --cmd "echo hello world"
Set hello in ~/.byk/alias/hi.byk.json
$ byk hello
hello worldWrite JSON, run short commands
One file holds every command in your project — no full paths or arguments to memorize
Command Aliases
{xxx} placeholders,$cwd / $mode three-level inheritance for$var variables with platform mapping.
Alias Configuration byk @run..setExact routing & file commands
Use @file.key to bypass merging and go straight to a file; to edit the file itself use @file..command — init, set, clone, link — no hand-written JSON.
File CommandsThe global file, without an editor
In a project the file is easiest to write by hand; for ~/.byk/alias/, file commands finish it in four lines.
terminal · a file in four commands
$ byk @@ops..init
$ byk @@ops..set clean --cmd "cargo clean"
$ byk @@ops..set serve --cmd "cargo run --release"
$ byk @@ops..set deploy --cmd "deploy --env {env}" \
--mode interactiveconfig · ~/.byk/alias/ops.byk.json
{
"clean": "cargo clean",
"deploy": {
"$cmd": "deploy --env {env}",
"$mode": "interactive"
}
"serve": "cargo run --release"
}Four options and a set of file commands
Besides aliases, this is all byk has.
byk -h
Banner, usage, options, and every alias at a glance; running bare is equivalent
byk -v
Version, commit, build date, platform, and install location
byk --paths
The actual locations of the CLI home and global alias directory
byk --check
Scan every alias file and report read, JSON, metadata, and link problems per file
byk @@ops..help
Built into every alias file: init, set, remove, clone, link, json, path
byk __api__
Read-only and never writes to disk: feeds data to shell completion and editor plugins
One entry point for every command
Options → hidden interface → file commands → @file.key → aliases — first match wins; on a miss, candidates are listed and it exits 1.
Near-first: project files (1) override global files (0), so short names work as soon as you cd in; to limit a file to itself, set $private.
A single Rust binary with native support for macOS / Linux / Windows (x86_64 / arm64).
Install the byk VS Code extension to run the alias under your cursor inside *.byk.json with a right-click — same experience as package.json scripts — and search all aliases from the command palette.
Install in seconds and turn everyday commands into short names