2F

20000419/fauxnix

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

898 stars 4 forks 품질 83 트렌드 36MIT

Windows에서 결정적 bash→PowerShell 번역을 통해 리눅스 스타일 명령을 실행할 수 있습니다. VM이나 WSL은 사용하지 않습니다. MCP 서버 + CLI AI 에이전트용으로 구축되었습니다(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입니다. PowerShell 5.1+(내장) 및 Node.js ≥ 18이 필요한 Windows가 필요합니다. (~/.codex/config.

개요(AI 번역)

Windows에서 리눅스 스타일 명령어를 실행하세요 — 네이티브, 결정론적으로, VM이나 WSL은 사용하지 않습니다.

fauxnix는 AI 에이전트를 위해 만들어진 bash→PowerShell 변환 계층입니다. 당신의 에이전트가 계속 bash는 이미 알고 있습니다 ([ls -la | grep foo, find . -name '*.ts' | wc -l, kill -9 1234), 그리고 fauxnix는 각 명령어를 결정론적으로 PowerShell로 변환하고, 네이티브로 실행하며, GNU/Linux와 비슷한 백 출력: ls -l 열, 배시 스타일의 오류 메시지, coreutils 종료 코드는 UTF-8/GBK가 자동으로 처리되었습니다.

Claude 코드 · 코덱스 · OpenCode · Kimi 코드 · Qwen 코드와 모든 MCP에 대한 원커맨 설치 클라이언트. 109개의 번역된 명령어 · 1,044개의 자동 테스트 · 270 사례 Git Bash 미분 코퍼스 및 41개의 보조 검사 · 런타임 중 LLM 호출이 0.

이 체크아웃은 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"
MCP 초보자라면? 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"] } } }