Komandare

The Core Idea: Bring the Environment to Your Tools

kRun: Inject the Environment

kRun code . boots Komandare first, then launches VS Code or any IDE with its PATH, toolchain variables, caches, and modules.

Zero Host Pollution

npm / pnpm / pip / playwright / Go module caches, Gradle user dirs, Ruby gems — everything stays inside the Komandare tree. Delete the folder and the host looks untouched.

Portable: One Directory Tree

Paths are anchored to the tree itself. Move it to another drive or machine and the toolchains, caches, and settings come with it.

AI Shell · NL to Commands

aishell — describe what you need in natural language and get a shell command, executed after a RUN confirmation. Works in Chinese and English.

Cygwin + Bash Toolchain

A complete Unix userland, Bash, /kbin, apt-cyg, and optional Node, Python, Go, PHP, and Ruby modules share one booted environment.

Quick Start

Launch kmd

Double-click kmd.exe. Prefers Windows Terminal; falls back to the bundled ConEmu.

First Boot

The first launch opens the kmd-welcome full-screen TUI wizard to pick and install modules.

Manage Modules

kmod-setup install python3x — add or remove toolchains anytime.

Take It Anywhere

Copy the whole tree anywhere; kInitrd.cmd re-anchors all paths automatically.

DIY — Build Your Own Modules

1Drop It In

Toss any portable software into Module/<name>/ — the folder name is the module name. A module is just a folder; no manifest needed.

2Register

kmod-setup install <name> generates a Config/Init.d/NN-<name>.cmd loader; the module joins PATH on next boot.

3Pack & Share

kmod-setup export <name> produces a .kmp package (a zip with kmp.ini + loader.cmd + module/) — send it to anyone to install.

4Distribute & Update

kmod-setup mirror switches download sources; users run kmod-setup install -r <name> to pull from the registry, and kmod-setup update checks remote versions with sha256 verification.

komandare —— kmd

demo@MYPC ~ $ kmod-setup install mytools 20 mytools 1.2.0 "Demo Labs" kmod-setup: registered mytools v1.2.0 (Demo Labs) at priority 20 module : C:\Komandare\Module\mytools loader : C:\Komandare\Config\Init.d\20-mytools.cmd demo@MYPC ~ $ kmod-setup export mytools mytools-1.2.0.kmp kmod-setup: exported mytools v1.2.0 -> C:\Komandare\mytools-1.2.0.kmp payload: Module/mytools (14.2M) demo@MYPC ~ $ kmod-setup install mytools-1.2.0.kmp kmod-setup: installed mytools v1.2.0 (Demo Labs) module : C:\Komandare\Module\mytools loader : C:\Komandare\Config\Init.d\10-mytools.cmd kmod-setup: loader executed

You can also hand-write loaders — NN-*.cmd files under Config/Init.d/ run in 00–99 order at boot; module env vars, junctions and cache dirs all belong there. It is the standard way to extend Komandare.

Path	Role
kmd.exe	Recommended launcher (Windows Terminal first, ConEmu fallback)
kRun.exe	Run any third-party program inside the kmd environment
kBash.bat / kCmd.bat	Enter the kmd environment from any terminal
kInitrd.cmd	Kernel entry — the bootloader where every launch path converges
Config/	Launcher config, module registry (Init.d/), aliases, cache policies, services
Module/	Toolchain modules, one folder per app, registered via Config/Init.d/*.cmd
Binary/	Portable standalone tools & wrappers (caddy, mitmproxy, cygwin-setup, ...)
Unixlike/	Cygwin userland: bin/, usr/, kbin/ (built-in commands), etc/, home/

Built-in Tools

/kbin — the command layer (takes precedence over regular bin)

Command	What it does
aishell	AI natural-language → shell command translator (OpenAI-compatible API, RUN-confirmed execution)
apt-cyg	Cygwin package manager (aliases: apt, apt-get, yum, apk)
kmod-setup	Module system package manager v4.3.0 (install / export / update / mirror, v2 registry, deps & hooks)
kmd-welcome	First-run setup wizard (full-screen TUI)
ver / version	neofetch + distro version (-s prints just the version)
neofetch	System info display
sudo / su	Trigger a Windows UAC elevation that opens a new root kmd window; unroot restores the normal-user mapping
service	Service manager dispatcher — resolves Config/Service/<name>.bat and runs actions
vihost	Edit /etc/hosts in nano as root (requires sudo)
wcmdbox / mobabox	Windows command box — powers ifconfig / hwinfo network & hardware info
ps / top / killall	Process observation (Windows-aware)
mkrootfs	Rebuild the kmod / kconf / tmp text-symlinks (idempotent)
phptest	Quick PHP scratchpad: opens a temp .php in nano, then runs it
mklink / attrib / dir	bash-style bridges for Windows mklink / attrib / dir
runas_root / runas_user	Remap /etc/passwd based on elevated status
reset / poweroff / reboot	Console reset & Windows power / reboot helpers

Command

What it does

aishell

AI natural-language → shell command translator (OpenAI-compatible API, RUN-confirmed execution)

apt-cyg

Cygwin package manager (aliases: apt, apt-get, yum, apk)

kmod-setup

Module system package manager v4.3.0 (install / export / update / mirror, v2 registry, deps & hooks)

kmd-welcome

First-run setup wizard (full-screen TUI)

ver / version

neofetch + distro version (-s prints just the version)

neofetch

System info display

sudo / su

Trigger a Windows UAC elevation that opens a new root kmd window; unroot restores the normal-user mapping

service

Service manager dispatcher — resolves Config/Service/<name>.bat and runs actions

vihost

Edit /etc/hosts in nano as root (requires sudo)

wcmdbox / mobabox

Windows command box — powers ifconfig / hwinfo network & hardware info

ps / top / killall

Process observation (Windows-aware)

mkrootfs

Rebuild the kmod / kconf / tmp text-symlinks (idempotent)

phptest

Quick PHP scratchpad: opens a temp .php in nano, then runs it

mklink / attrib / dir

bash-style bridges for Windows mklink / attrib / dir

runas_root / runas_user

Remap /etc/passwd based on elevated status

reset / poweroff / reboot

Console reset & Windows power / reboot helpers

Aliases — everyday shortcuts (Config/SystemAliases.ini, overridable via UserAliases.ini)

Alias	Points to
apt / apt-get / yum / apk	bash apt-cyg — the Cygwin package manager
sudo	gsudo — elevate via a UAC prompt
su / nosu	sh /kbin/su · sh /kbin/unroot — switch to a root window / restore the normal-user mapping
ver / version	sh /kbin/version — neofetch + distro version
gl	git log --oneline --all --graph --decorate
gm	git add . && git commit -m <msg> && git push — commit & push in one go
vi	vim — the everyday editor
np	notepad — Windows Notepad
ls / la / ll	ls with --color=auto, skipping NTUSER.* / ntuser.*
d / desktop	cd $DESKTOP — jump to the desktop
e.	explorer . — open the current dir in Explorer
ifconfig / hwinfo	mobabox ifconfig / hwinfo — network & hardware info
mtr	ntr — network traffic replay & analysis
webd	python3 -m http.server — quick HTTP server
clear / cls	cmd /c clear · cmd /c cls — clear the screen

Alias

Points to

apt / apt-get / yum / apk

bash apt-cyg — the Cygwin package manager

sudo

gsudo — elevate via a UAC prompt

su / nosu

sh /kbin/su · sh /kbin/unroot — switch to a root window / restore the normal-user mapping

ver / version

sh /kbin/version — neofetch + distro version

git log --oneline --all --graph --decorate

git add . && git commit -m <msg> && git push — commit & push in one go

vim — the everyday editor

notepad — Windows Notepad

ls / la / ll

ls with --color=auto, skipping NTUSER.* / ntuser.*

d / desktop

cd $DESKTOP — jump to the desktop

explorer . — open the current dir in Explorer

ifconfig / hwinfo

mobabox ifconfig / hwinfo — network & hardware info

mtr

ntr — network traffic replay & analysis

webd

python3 -m http.server — quick HTTP server

clear / cls

cmd /c clear · cmd /c cls — clear the screen

Binary/ — portable standalone tools (auto on PATH)

Tool	Use
caddy	Lightweight HTTP / reverse-proxy server
mitmproxy / mitmdump / mitmweb	Interactive HTTPS interception & analysis
plink / scp / sftp	PuTTY SSH CLI clients
tcping	TCP ping — check if a port accepts connections
RawCap	Capture raw traffic on a local interface to a pcap file
streams / streams64	Strip NTFS Alternate Data Streams (Mark-of-the-Web)
cygwin-setup	Official Cygwin setup-x86_64.exe (full package manager)
composer / phpunit	PHP dependency manager / PHPUnit test runner (.phar wrappers)
binwalk / jefferson	Firmware extraction & file-system analysis (front-ends for the Python tools in Module/)
desktopini	Interactively set a folder's display name / icon via desktop.ini
pptp-dial	Dial / disconnect a PPTP VPN (dial <addr> <user> <pass>)
MoveLater	Defer a file deletion to the next reboot
kmd_reset	Reset the ConEmu tab title to "Komandare"

Tool

Use

caddy

Lightweight HTTP / reverse-proxy server

mitmproxy / mitmdump / mitmweb

Interactive HTTPS interception & analysis

plink / scp / sftp

PuTTY SSH CLI clients

tcping

TCP ping — check if a port accepts connections

RawCap

Capture raw traffic on a local interface to a pcap file

streams / streams64

Strip NTFS Alternate Data Streams (Mark-of-the-Web)

cygwin-setup

Official Cygwin setup-x86_64.exe (full package manager)

composer / phpunit

PHP dependency manager / PHPUnit test runner (.phar wrappers)

binwalk / jefferson

Firmware extraction & file-system analysis (front-ends for the Python tools in Module/)

desktopini

Interactively set a folder's display name / icon via desktop.ini

pptp-dial

Dial / disconnect a PPTP VPN (dial <addr> <user> <pass>)

MoveLater

Defer a file deletion to the next reboot

kmd_reset

Reset the ConEmu tab title to "Komandare"

Module/ — optional toolchain modules (one-command install via kmod-setup)

Module	Contents
aishell	AI natural-language → shell command translator
python3x	Python 3.12 — pip cache, Playwright browsers, user-site all inside the module
nodejs	Node.js + npm / pnpm / npx (caches contained)
golang	Go toolchain — GOMODCACHE & co. inside the module
gradle	Gradle build tool (GRADLE_USER_HOME contained)
php	PHP CLI + composer (with the phptest scratchpad)
ruby / ruby4	Two Ruby stacks (gems contained)
qemu	QEMU VM (with vbox-helper)
adb / fastboot	Android debug bridge & flashing tools
gsudo	UAC elevation backend for sudo
7zip / unzip	Archive toolchain
dig / iperf3 / socat	DNS lookup / network perf / socket relay
lessc / ntr	Less compiler / network traffic replay & analysis
selfsign-ssl	Self-signed SSL certificate generator
squashfs-tools	squashfs image pack/unpack
windows-driver-sign	Windows driver signing toolchain
vbox-helper	VirtualBox helper (backend for service docker)
vbox	VirtualBox runtime
z-cache-clean	Auto-maintains module caches at boot per CacheClean.ini

Module

Contents

aishell

AI natural-language → shell command translator

python3x

Python 3.12 — pip cache, Playwright browsers, user-site all inside the module

nodejs

Node.js + npm / pnpm / npx (caches contained)

golang

Go toolchain — GOMODCACHE & co. inside the module

gradle

Gradle build tool (GRADLE_USER_HOME contained)

php

PHP CLI + composer (with the phptest scratchpad)

ruby / ruby4

Two Ruby stacks (gems contained)

qemu

QEMU VM (with vbox-helper)

adb / fastboot

Android debug bridge & flashing tools

gsudo

UAC elevation backend for sudo

7zip / unzip

Archive toolchain

dig / iperf3 / socat

DNS lookup / network perf / socket relay

lessc / ntr

Less compiler / network traffic replay & analysis

selfsign-ssl

Self-signed SSL certificate generator

squashfs-tools

squashfs image pack/unpack

windows-driver-sign

Windows driver signing toolchain

vbox-helper

VirtualBox helper (backend for service docker)

vbox

VirtualBox runtime

z-cache-clean

Auto-maintains module caches at boot per CacheClean.ini