kiriya

kiriya

One command-line toolbox for everyday developer work that behaves the same on Windows, Linux and macOS.

kiriya (ကိရိယာ, Burmese for "tool") saves remembering del and rm, netstat -ano and lsof -i, clip and pbcopy, or writing a one-off script for each. It is one Node.js program with no runtime dependencies. Every command answers --json, and convert json --get reads a value back out of that answer without a second tool. Changes to many files show a plan first, deletions go to the trash, and nothing that cannot be undone happens until you type a confirmation. AI agents can use the same commands over MCP, under the same rules.

Install

kiriya needs Node.js 22.13 or later.

npm install --global kiriya

Then check what this machine gives it:

kiriya doctor

Every release is published from CI with provenance, so npm audit signatures can show which workflow built the copy you installed. Every module below is tested on Windows, Linux and macOS with Node.js 22, 24 and the current release.

Getting started takes it from there, and CONTRIBUTING.md covers building from source.

Quick start

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

Finding your way

Help goes three steps deep, and each step names the next, so nothing has to be guessed.

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 says the same as that third line. The middle step lists each command's option names underneath it, so a module's whole surface fits on one screen:

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

Every module also has a guide below with a full reference: every command, argument and option, what each does, and whether it can be undone.

Modules

AI agents

kiriya mcp serves these commands to AI agents over the Model Context Protocol. It offers only commands that change nothing until you allow more, and asks you before any work that cannot be undone. MCP server shows how to add it to a client.

Documentation

Project

Changelog · Security policy · Code of conduct · MIT licence