
通过确定性 bash→PowerShell 翻译在 Windows 上运行 Linux 风格命令。没有虚拟机,没有 WSL。为 AI 代理构建的 MCP 服务器 + CLI(Claude Code、Codex、OpenCode 等)。
概览
fauxnix 是为 AI 代理构建的 bash→PowerShell 翻译层。你的代理继续写它已知的 bash(ls -la | grep foo,find . -name '*.ts' | wc -l, kill -9 1234),fauxnix 确定性地将每个命令翻译成 PowerShell,原生执行,并回传看起来像 GNU/Linux 的输出:ls -l 列、bash 风格的错误消息、coreutils 退出码、自动处理的 UTF-8/GBK。 只需一个命令安装,即可安装任意MCP客户端。 idempotent;准确打印了哪些更改了。如果你喜欢自己编辑配置文件,下面是手动配置。 NPM 包名为 fauxnix-cli(NPM 上的 Fauxnix 名称属于一个无关的 2015 Websocket 库);安装的命令是 fauxnix。需要 Windows 内置 PowerShell 5.1+ 和 Node.js ≥ 18。 (~/.codex/config。
概述(AI 翻译)
在Windows上运行类似Linux的命令——原生、确定性地运行,没有虚拟机,也没有WSL。
fauxnix 是一个为 AI 代理构建的 bash→PowerShell 翻译层。你的代理不断写入
bash它已经知道(ls -la | grep foo,find . -name '*.ts' | wc -l,kill -9 1234),并且
fauxnix 确定性地将每个命令翻译成 PowerShell,原生执行,并交付
返回输出看起来像 GNU/Linux:ls -l 列,bash 风格的错误信息,coreutils 退出
代码,UTF-8/GBK 自动处理。
Claude Code ·Codex ·OpenCode ·Kimi Code ·Qwen Code 以及任意 MCP 的一命令安装 客户端。109个翻译命令 ·1,044个自动测试 ·270个案例的Git Bash微分 语料库加上41次补充检查·运行时零LLM调用。
本次检查准备了 v2.0.0。参见迁移和发布说明
对于Node.js要求,修改了文件操作合同和验证限制。
npm徽章和@latest示例显示了发布版本直到出版完成。
现在试试——无需安装
连接你的代理——一个命令
idempotent;打印的正是更改内容。如果你喜欢编辑,下面是手动配置
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
fauxnix
Run Linux-style commands on Windows — natively, deterministically, no VM, no WSL.
fauxnix is a bash→PowerShell translation layer built for AI agents. Your agent keeps writing the
bash it already knows (ls -la | grep foo, find . -name '*.ts' | wc -l, kill -9 1234), and
fauxnix deterministically translates each command into PowerShell, executes it natively, and hands
back output that looks like GNU/Linux: ls -l columns, bash-style error messages, coreutils exit
codes, UTF-8/GBK handled automatically.
One-command install for Claude Code · Codex · OpenCode · Kimi Code · Qwen Code, plus any MCP client. 109 translated commands · 1,044 automated tests · 270-case Git Bash differential corpus plus 41 supplementary checks · zero LLM calls at runtime.
This checkout prepares v2.0.0. See migration and release notes
for the Node.js requirement, changed file-operation contracts and verification limits.
The npm badge and @latest examples show the published version until publication completes.
Try it now — no install
npx fauxnix-cli@latest "ls -la src | head -3"
npx fauxnix-cli@latest translate "find . -name '*.log' -mtime +7 -delete"
$ fauxnix "ls -la src | head -2"
-rw-r--r-- 1 me me 1204 Aug 16 09:12 ast.ts
-rw-r--r-- 1 me me 8192 Aug 16 09:12 cli.ts
$ fauxnix "cat nope.txt"
cat: nope.txt: No such file or directory # not a PowerShell stack trace
Connect your agent — one command
npm install -g fauxnix-cli
fauxnix install --claude # or --codex / --opencode / --kimi / --qwen
fauxnix doctor # verifies encoding, harness config, and MCP round-trip
Idempotent; prints exactly what changed. Manual configurations below if you prefer to edit config files yourself.
npm package name is
fauxnix-cli(thefauxnixname on npm belongs to an unrelated 2015 websocket library); the installed command isfauxnix. Requires Windows with PowerShell 5.1+ (built-in) and Node.js ≥ 22.20.0. Node 18/20 are unsupported in v2. Current Node 22/24 LTS patches are tested. Published v1.0.0 retains its original metadata.
fauxnix install -- writes the spawn-safe form shown below: the absolute Node
安装
npx fauxnix-cli@latest "ls -la src | head -3"配置
{
"mcpServers": {
"fauxnix": {
"command": "C:\\Program Files\\nodejs\\node.exe",
"args": ["C:\\Users\\<you>\\AppData\\Roaming\\npm\\node_modules\\fauxnix-cli\\dist\\index.js", "mcp"]
}
}
}