fauxnix MCP

Установка

Работает в

• Claude Code
• Codex
• OpenCode
• SourceCraft
• Koda
• Coddy

Ручная установка

npm install -g fauxnix-cli

Что делает

fauxnix — слой перевода команд для агента на Windows: агент пишет привычный bash (`ls -la | grep foo`, `find . -name '*.ts' | wc -l`), а fauxnix детерминированно переводит каждую команду в PowerShell, выполняет эту команду через .NET и возвращает вывод в формате GNU: колонки `ls -l`, сообщения об ошибках в стиле bash вместо дампов `CategoryInfo`, коды возврата coreutils, автоматическую обработку UTF-8 и GBK. Переведено 109 команд: работа с файлами, обработка текста, процессы, архивы, базовая сеть, сверенные построчно с реальным GNU coreutils через Git Bash на этапе разработки. Команда `fauxnix mcp` поднимает stdio MCP-сервер с одним инструментом `bash` (имя меняется переменной `FAUXNIX_TOOL_NAME`), который держит сессию как обычный вход в оболочку: текущая папка, переменные окружения, экспорт и `cd -` сохраняются между вызовами инструмента. Инструмент `bash_batch` компилирует весь план из нескольких шагов до начала выполнения, выполняет его атомарно в одной сессии и останавливается на первом шаге с ненулевым кодом возврата, если не указано иное. Установка `fauxnix install --claude` подключает MCP-сервер к Claude Code одной командой, а экспериментальный режим `fauxnix install --claude-shell` подменяет встроенный в Claude Code Bash на собранный бинарник на основе node.exe, который сам отвечает на bash-синтаксис без отдельного MCP-сервера и дополнительных обращений по протоколу на каждую команду.

Для кого. Для тех, кто запускает агентов на Windows без WSL и Git Bash и хочет, чтобы агент продолжал писать привычный bash, получая результат в формате GNU, а не сырой вывод PowerShell.

Пример запроса к агенту

Найди в проекте все файлы .log старше 7 дней и покажи их размер, используй обычные bash-команды

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

Лицензия MIT.

• Требует Windows с PowerShell 5.1 или новее (встроен) и Node.js 22.20.0 или новее; версии Node 18 и 20 в этой версии не поддерживаются.
• Переведенное подмножество покрывает 109 команд из файловых операций, обработки текста, процессов, архивов и базовой сети, а не всю Linux-оболочку: на непереведенной команде инструмент останавливается с понятной ошибкой, а не выполняет ее приблизительно.
• Экспериментальный режим `--claude-shell` подменяет встроенный Bash Claude Code копией node.exe весом около 85 мегабайт с внедренной логикой через Node SEA, автор сам называет его компромиссным решением до появления компактной сборки.
• Имя пакета в npm — `fauxnix-cli`, а не `fauxnix`: короткое имя уже занято несвязанной библиотекой для веб-сокетов 2015 года, при этом установленная команда называется `fauxnix`.
• В неинтерактивном режиме `codex exec` вызовы инструментов MCP по умолчанию отклоняются слоем подтверждения Codex: нужен либо флаг обхода песочницы, либо интерактивный запуск с ручным подтверждением.

Как отключить. Выполните `fauxnix install --claude-shell-off`, чтобы вернуть прежнюю настройку Bash в Claude Code, затем удалите запись fauxnix из конфигурации MCP (`claude mcp remove fauxnix`) или уберите блок `mcpServers`/`mcp` для fauxnix из конфигурации другого клиента, после чего `npm uninstall -g fauxnix-cli`.

Коротко о README

Описание репозитория открывается значками версии npm, числа загрузок и оценки на каталоге Glama, а первый блок дает команду npx для пробного запуска без установки. Отдельный раздел «Измерено» приводит таблицу сравнения с чистым PowerShell на одной модели и пяти задачах и ссылки на полные замеры по семи моделям. В конце идет таблица переведенных команд по категориям (файлы, текст, процессы, архивы, сеть) и перечень известных пределов перевода.