PlugWiki
Fauxnix logo

Fauxnix MCP Server: Run Bash-Style Commands on Windows in Claude, Cursor and Other Apps

OfficialLocal
Getnpmfauxnix-cli20000419/fauxnix

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.

Install Fauxnix MCP

Claude Code

  1. 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. 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 · bash

  • Runs 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_batch

  • Shows 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_translate

  • Shows 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-onlyNo read-only mode is documented. The bash and bash_batch tools are marked destructive in their annotations.
Talks toWhatever the commands you run connect to
Sign-in and keysNo 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

GitHubnpmChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. README · github.com
  2. mcp.ts · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.