
Fauxnix MCP Server: Run Bash-Style Commands on Windows in Claude, Cursor and Other Apps
Lets Claude Code, Codex, OpenCode and other agents run Linux-style commands on Windows, translated to PowerShell with no WSL or VM.
Fauxnix gives your agent a bash-style shell on Windows. It translates commands such as ls, grep and find into PowerShell and prints output that looks like GNU tools, so the agent's usual commands work. It needs Windows with PowerShell 5.1 and Node.js 22.20 or newer.
The shell runs real commands on your machine with your permissions. Only use it where you would let the agent run a terminal.
Good for
- Windows users whose coding agent keeps writing bash commands that fail
- Developers who do not want to install WSL, Git Bash or a virtual machine
- Teams whose agents run on mixed Windows and Linux machines
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Fauxnix MCP
Claude Code
- 1
Copy this prompt.
Add the Fauxnix MCP server to Claude Code. Run this command: claude mcp add fauxnix -- npx -y fauxnix-cli mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js, Windows PowerShell 5.1+, Node.js 22.20+.
Needs Windows. The npx form adds the mcp subcommand to the package name and is adapted by us. After a global install, the README runs the server as fauxnix mcp.
Built from the package data we hold. Not yet tested by us.
Tools
Runs a bash-style command on your Windows PC
Translates a Linux-style command line into PowerShell and runs it on your machine. The shell keeps its folder, variables and arguments between calls, and returns exit codes like bash. The tool name can be changed with FAUXNIX_TOOL_NAME.
Try: “Find all .log files older than 7 days under the current folder.”
Runs code ·
bashRuns several known commands in one go
Compiles a list of commands first, then runs them one after another in the same shell session and returns a result for each step. It stops at the first failure unless you turn that off.
Try: “Write data.txt, count its bytes, then delete it, all in one batch.”
Runs code ·
bash_batchShows the PowerShell for a bash command without running it
Returns the PowerShell that a bash-style command would become. Nothing is executed.
Try: “Show me the PowerShell for 'find . -name *.log | wc -l'.”
Read ·
fauxnix_translateShows or resets the shell session
Reports the current folder, tracked environment variables and session ID, or resets the shell to a fresh state.
Try: “Reset the shell session.”
Write ·
fauxnix_session
Read from the source code
Permissions
high risk · 4 things to watch
High risk
The assistant can run any command on your Windows PC, including deleting files. Approve commands one by one and avoid running it on a machine with data you cannot lose.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It runs any command with your permissions
The bash and bash_batch tools run commands in a PowerShell session on your PC, including deleting files and starting programs such as git, node and python. Approve commands one by one, or use a separate account or machine. github.com
The shell keeps state between calls
Folder, environment variables and exports persist across calls until the session is reset. Check the current folder before you approve destructive commands. github.com
The installer edits your agent's config
The fauxnix install command writes the MCP entry into the agent's own settings file (for example the Claude, Codex, OpenCode, Kimi or Qwen config). The optional Claude shell mode builds a replacement bash.exe of about 85 MB and changes a setting. Skip both and use the manual config if you prefer. github.com
The tool description tells the model to prefer batches
The bash description says to prefer bash_batch when two or more commands are known, which steers the assistant toward running several commands per approval. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. The bash and bash_batch tools are marked destructive in their annotations. |
|---|---|
| Talks to | Whatever the commands you run connect to |
| Sign-in and keys | No account or API key. |
Questions
Is the Fauxnix MCP server official?
It is the project's own server, published by its author as the fauxnix-cli package. It is not made by Microsoft or the PowerShell team.
Does it work on Mac or Linux?
No. It runs commands through Windows PowerShell 5.1 or newer. Without PowerShell on the path the bash tool returns an error instead of running anything.
Is it a sandbox or virtual machine?
No. Commands run natively on your Windows machine with your permissions. It replaces WSL or a VM, so it does not isolate anything.
What Node.js version does it need?
Node.js 22.20.0 or newer. The README says Node 18 and 20 are not supported in version 2.
Why is the npm package called fauxnix-cli?
The plain fauxnix name on npm belongs to an unrelated 2015 websocket library. Install fauxnix-cli, which gives you the fauxnix command.
Does it need an API key?
No. It runs locally and has no account or key.
How do I add it to Claude Code or Codex?
Use the matching tab in the install box above. The README also offers a one-command installer that writes the entry for you.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
fauxnix-cli- Registry
- npm
- Transport
- stdio
- Auth
- None
- Version
- 2.1.1
- License
- MIT
- Last commit
- Oct 24, 2026
- Open issues
- 4
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.