2F

20000419/fauxnix

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

898 stars 4 forks 质量 83 趋势 36MIT

通过确定性 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 (the fauxnix name on npm belongs to an unrelated 2015 websocket library); the installed command is fauxnix. 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

在 GitHub 查看完整 README

安装

npx fauxnix-cli@latest "ls -la src | head -3"
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "fauxnix": { "command": "C:\\Program Files\\nodejs\\node.exe", "args": ["C:\\Users\\<you>\\AppData\\Roaming\\npm\\node_modules\\fauxnix-cli\\dist\\index.js", "mcp"] } } }