{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "20000419-fauxnix--codex-bash-on-windows-via-mcp",
 "repo": "20000419/fauxnix",
 "repo_url": "https://github.com/20000419/fauxnix",
 "repo_slug": "20000419-fauxnix",
 "title": "Run Codex bash commands on Windows through Fauxnix",
 "page_title": "How to run Codex bash commands on Windows through Fauxnix with Fauxnix",
 "summary": "Add Fauxnix as an MCP server in Codex so bash-style steps run on a Windows machine.",
 "who": "A developer on Windows who uses Codex for scripted or automated tasks and needs bash-style commands to run without a Linux environment.",
 "problem": "Codex 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.",
 "outcome": "Codex calls the Fauxnix bash tool for its shell steps, and the output matches GNU-style results for the supported commands.",
 "steps": [
  "`npm install -g fauxnix-cli`",
  "`codex mcp add fauxnix -- fauxnix mcp`",
  "Add the `[mcp_servers.fauxnix]` block with `command = \"fauxnix\"` and `args = [\"mcp\"]` to `~/.codex/config.toml` if 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"
 ],
 "agent_prompt": "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.",
 "agents": [
  "codex"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "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.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "typescript",
 "requirements": [
  "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"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/20000419-fauxnix/codex-bash-on-windows-via-mcp/",
 "md": "https://dedupedai.com/use-cases/20000419-fauxnix/codex-bash-on-windows-via-mcp/index.md",
 "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 hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/20000419-fauxnix--codex-bash-on-windows-via-mcp.json",
 "api_version": "v1"
}