kiriya

kiriya

一个日常开发工作命令行工具箱，在 Windows、Linux 和 macOS 上的行为完全一致。

kiriya（ကိရိယာ，缅甸语中的“工具”）让你不必再记 del 和 rm、netstat -ano 和 lsof -i、clip 和 pbcopy 之间的区别，也不必为每项任务单独编写一次性脚本。它是一个 没有运行时依赖的 Node.js 程序。每条命令都支持 --json，而 convert json --get 可以从该输出中读取值，无需借助第二个工具。批量修改文件时会先显示计划，删除的文件会移入回收站；在你输入确认之前，不会执行任何不可撤销的操作。AI Agent 也可以通过 MCP 使用相同的命令，并遵循相同的规则。

安装

kiriya 需要 Node.js 22.13 或更高版本。

npm install --global kiriya

然后检查这台机器能为它提供什么：

kiriya doctor

每个版本都通过 CI 发布，并附带来源证明， 因此，npm audit signatures 可以显示构建你所安装版本的工作流。下文中的每个模块 都使用 Node.js 22、24 和当前版本，在 Windows、Linux 和 macOS 上进行了测试。

入门指南会带你继续了解，CONTRIBUTING.md介绍了如何从源代码构建。

快速开始

kiriya doctor                                   # what this machine offers kiriya
kiriya port who 3000                            # which process holds port 3000
kiriya files find --name "*.log" --older 30d    # the same search in every shell
kiriya files delete dist --dry-run              # the plan, before anything changes
kiriya git status ~/code --json                 # every repository under a folder, as JSON

查找所需内容

帮助分为三层，每一层都会指出下一步，因此无需猜测。

kiriya --help              # the modules, and the options every command accepts
kiriya help files          # one module: its commands, and what each one takes
kiriya help files delete   # one command: its arguments, options and examples

kiriya files delete --help 的说明与第三行相同。中间一层会在每条命令下列出其选项名称，因此一个模块的所有功能一屏就能看完：

Commands
  delete   Send files and folders to the trash, or remove them for good with --permanent
           --permanent --dry-run --yes --confirm --all
  find     Find files and folders by name, extension, type, size, age or emptiness
           --name --ext --type --larger --smaller --newer --older --empty --all --limit

下文还为每个模块提供了一份完整参考指南，涵盖所有命令、参数和选项、各自的作用，以及是否可以撤销。

模块

模块	功能
archive	创建和打开 ZIP、tar.gz 归档文件，在所有操作系统上的操作方式都相同，无需安装 zip、tar 或 7-Zip。
clip	复制文本到剪贴板并粘贴回来，在所有操作系统上都能保留 Unicode。
completion	为 bash、zsh、fish 和 PowerShell 中的 kiriya 模块、命令、选项和值提供 Tab 补全。
config	kiriya 自身的设置（例如要加载的插件），每位用户各存储在一个文件中。
convert	在 base64、hex、URL 编码、JSON、JWT、时间和大小写格式之间转换文本，所有操作都在本机完成。
docker	管理当前文件夹中项目的 docker compose，并预览对引擎的清理操作。
doctor	检查本机为 kiriya 提供的支持：运行时、配置、回收站、剪贴板、git、docker 和插件。
env	以相同方式读取所有操作系统上的环境变量、PATH 和 .env 文件。
files	文件和文件夹：创建、查找、读取、搜索、比较、复制、移动、重命名和删除，在所有操作系统上的操作方式都相同。
gen	使用操作系统的安全随机源生成随机标识符、密码和令牌。
git	管理文件夹下所有仓库中的 Git：查看状态、获取、拉取和切换。
net	以相同方式查看所有操作系统上的本地地址、TCP 可达性并查询 DNS。
open	使用默认应用打开文件或文件夹，或在浏览器中打开网址。
port	查看哪个进程正在监听 TCP 端口、结束该进程，或查找空闲端口，在所有操作系统上的操作方式都相同。
proc	列出、查找和结束进程，并以树状结构显示进程，在所有操作系统上的操作方式都相同。
secrets	查找文件夹文件中已提交的机密：暴露在明处的令牌、私钥和密码。
self-update	查询注册表中是否有更新版本的 kiriya，并使用 --apply 安装。
sys	以相同方式描述所有操作系统上的本机和开发工具。
wait	等待端口开始监听、网址响应或文件出现，在所有操作系统上的操作方式都相同。

AI Agent

kiriya mcp 会通过 Model Context Protocol 向 AI Agent 提供这些命令。在你允许更多操作之前，它只提供不会造成任何更改的命令；对于无法撤销的操作，它会先征求你的同意。MCP 服务介绍了如何将其添加到客户端。

文档

主题	阅读
使用 kiriya	入门 · 用法 · 模块
指南	MCP 服务 · Tab 补全 · 插件
贡献	CONTRIBUTING.md · 架构 · 设计
全部内容	文档索引

项目

更新日志 · 安全政策 · 行为准则 · MIT 许可证