Who it is forA developer on Windows who uses Codex for scripted or automated tasks and needs bash-style commands to run without a Linux environment.
The problemCodex tool calls issued as bash fail on Windows when PowerShell is the only shell, and setting up WSL or Git Bash is more work than the task justifies.
The outcomeCodex calls the Fauxnix bash tool for its shell steps, and the output matches GNU-style results for the supported commands.
What you need first
- A Windows machine with PowerShell 5.1 or later (built in)
- Node.js 22.20.0 or later (Node 18 and 20 are unsupported in v2)
- npm to install the fauxnix-cli package
- An agent harness such as Claude Code, Codex, OpenCode, Kimi Code, Qwen Code, or any MCP client
Steps
npm install -g fauxnix-clicodex mcp add fauxnix -- fauxnix mcp- Add the
[mcp_servers.fauxnix]block withcommand = "fauxnix"andargs = ["mcp"]to~/.codex/config.tomlif you prefer editing the file (inferred, check the README) fauxnix doctor- For
codex exec, run with--dangerously-bypass-approvals-and-sandbox, or run interactively and approve the MCP tool once
Prompt for your agent
In the 20000419/fauxnix repo context, call the fauxnix `bash` MCP tool with `find . -name '*.ts' | wc -l` in <project-dir>. Expect a single number as output with bash-style exit code 0, then confirm `fauxnix doctor` passes.
Caveat. The README notes that in non-interactive `codex exec` mode MCP tool calls are auto-denied unless the bypass flag is passed or the tool is approved interactively, so plan the approval step before automating.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Disclaimer
Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked "Seen in the wild", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email [email protected] and we will look at it promptly. Full disclaimer page