kiriya

io.github.SatPaingOoPublished by GitHub account SatPaingOov0.3.0Updated Oct 24, 2026

Developer tools for files, git, ports, processes and more, the same on Windows, Linux and macOS

VerifiedSTDIODesktop onlyFiles & StorageDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

A local MCP server exposing kiriya's cross-platform developer toolbox: files, git, ports, processes, archives, encoding and more, with safety confirmations.

What you can do
Find, read, search, compare, copy, move, rename and delete files and folders, with deletions going to the trash and multi-file changes shown as a plan first. Check git status, fetch, pull and switch across every repository under a folder. Inspect and end processes, see which process holds a TCP port, find a free port, and check local addresses, TCP reachability and DNS. Make and open ZIP and tar.gz archives, and convert text between base64, hex, URL encoding, JSON, JWT, times and cases. Read environment variables, PATH and .env files, generate random identifiers, passwords and tokens, and scan a folder for committed secrets.
When to use it
Useful when you want an assistant to handle everyday local developer chores the same way on Windows, Linux and macOS, such as cleaning up build output, checking repository status across a folder, or finding what holds a port. It is meant for agents that should act only after confirmation on anything irreversible.
Requirements
Runs as a local process via npx from the npm package kiriya. Needs Node.js 22.13 or later. No accounts, API keys or environment variables are declared. A doctor command checks runtime, trash, clipboard, git, docker and plugins on the machine.
Before you install
It can delete files and folders, end processes and switch git branches; the README says deletions go to the trash and irreversible work waits for confirmation, but permanent deletion and process termination are still destructive. The secrets module reads files looking for tokens, private keys and passwords, so results may contain sensitive values. Self-update can install a newer version when applied.

Installation

In SourceWeft

  1. Open kiriya in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

bash
npm install --global kiriya

Then check what this machine gives it:

bash
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

bash
kiriya doctor                                   # what this machine offers kiriyakiriya port who 3000                            # which process holds port 3000kiriya files find --name "*.log" --older 30d    # the same search in every shellkiriya files delete dist --dry-run              # the plan, before anything changeskiriya 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.

bash
kiriya --help              # the modules, and the options every command acceptskiriya help files          # one module: its commands, and what each one takeskiriya 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:

text
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

ModuleWhat it does
archiveZIP and tar.gz archives, made and opened the same way on every OS with no zip, tar or 7-Zip installed.
clipCopy text to the clipboard and paste it back, with Unicode intact on every OS.
completionTab completion for kiriya's modules, commands, options and values in bash, zsh, fish and PowerShell.
configkiriya's own settings, such as the plugins to load, in one file per user.
convertConvert text between base64, hex, URL encoding, JSON, JWT, times and cases, entirely on this machine.
dockerdocker compose for the project in the current folder, and a previewed clean-up of the engine.
doctorCheck what this machine gives kiriya: runtime, configuration, trash, clipboard, git, docker and plugins.
envEnvironment variables, PATH and .env files, read the same way on every OS.
filesFiles and folders: create, find, read, search, compare, copy, move, rename and delete, the same on every OS.
genRandom identifiers, passwords and tokens from the operating system's secure random source.
gitGit across every repository under a folder: status, fetch, pull and switch.
netLocal addresses, TCP reachability and DNS lookups, the same on every OS.
openOpen a file or folder in its default application, or a web address in the browser.
portSee which process listens on a TCP port, end it, or find a free port, the same on every OS.
procList, find and end processes, and show them as a tree, the same on every OS.
secretsFind secrets committed into a folder's files: tokens, private keys and passwords in plain sight.
self-updateAsk the registry whether a newer kiriya exists, and install it with --apply.
sysThis machine and the developer tools on it, described the same way on every OS.
waitWait until a port listens, a web address answers or a file appears, the same way on every OS.

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

ForRead
Using kiriyaGetting started · Usage · Modules
GuidesMCP server · Tab completion · Plugins
ContributingCONTRIBUTING.md · Architecture · Design
EverythingDocumentation index

Project

Changelog · Security policy · Code of conduct · MIT licence

Source: README.md at commit 332da3c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

6
  1. v0.3.0LatestOct 9, 2026
  2. v0.2.0Oct 3, 2026
  3. v0.1.3Oct 3, 2026
  4. v0.1.2Sep 24, 2026
  5. v0.1.1Sep 23, 2026
  6. v0.1.0Sep 23, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts