v0.5.0·MIT·Rust

byk

轻量级、可扩展的命令行工具集

Features are opt-in. Nothing is created until you need it.

$pip install byk

~ — byk

$ byk hello
hello world

$ byk add fcbyk/hello
✓ plugin installed · ~/.byk/plugins/hello

$ byk dev
# running pnpm dev in ~/project/web

核心能力

一个二进制，按需启用

npm 管理、命令别名、插件系统——都是可选初始化，零隐式副作用。

byk ni

npm 命令管理

在 byk 独立作用域（~/.byk/node-pkgs）下管理 npm CLI，不污染全局环境。首次 byk add npm 自动创建 ni / nu 别名。

内置命令 byk ssh.prod

命令别名

把冗长命令集中到 *.byk.json。支持{xxx} 占位符、$cwd、$interactive 三级继承。

开始使用别名 byk add

插件系统

从 GitHub 一键安装 Python 插件，在隔离 venv 中运行。支持 py-script、py-module、pip-bin、bin 四种类型。

插件协议

命令别名

用 JSON 描述你的命令集合

一个文件管完项目里所有命令——占位符、交互式输入、精确执行语法都在这里。

config · run.byk.json

run.byk.json

{
  "$cwd": "~/project/web",
  "dev":   "pnpm dev",
  "build": "pnpm build",
  "deploy": {
    "$cmd": "deploy --env {env}",
    "$interactive": true
  }
}

terminal · 执行效果

terminal

$ byk dev
# running pnpm dev in ~/project/web

$ byk deploy
# prompts for env, then executes

$ byk @release.bump patch
# precise: release.byk.json → bump

插件

任何 GitHub 仓库都能成为插件源

根目录放一个 byk.json 即可。四种安装方式：

远程仓库

byk add user/repo

安装 byk.json 中的 $default（或唯一）key

指定 key

byk add user/repo/my-key

当 byk.json 含多个插件时精确指定

指定版本

byk add user/repo@v1.0/hello

@ 语法指定 branch / tag / commit

CDN 加速

byk add --cdn user/repo

raw.githubusercontent.com → jsDelivr

为什么选 byk

为不喜欢副作用的人设计

01按需启用

npm / 补全 / 缓存 / venv 都是可选初始化（byk add <feature>），无任何隐式副作用。

02隔离环境

插件运行在专属 venv（~/.byk/venv），与系统 pip 隔离；别名和 npm 也有独立作用域。

03跨平台

Rust 编译产物，原生支持 macOS / Linux / Windows（x86_64 / arm64）。

04零 Python 依赖

Shell 脚本一键安装即可使用 byk 本体；需要插件时才要求 Python。

05生态开放

byk.json 协议简洁；支持 Ref 引用、$var 变量替换、$default 默认 key、跨仓库拆分。

06清晰的优先级

命令按内置 → 全局选项 → 插件 → NPM → @file.key → 别名顺序匹配，第一个命中即执行。

byk

几秒钟安装，立刻提升你的终端效率

查看 CLI 文档 Star on GitHub