{"_id":"@ambiently-work/faux","name":"@ambiently-work/faux","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@ambiently-work/faux","version":"0.0.1","description":"POSIX-ish shell that runs entirely in-process — no child_process, no subshell. Virtual FS, builtins, and an optional WASM-accelerated runtime.","license":"MIT","author":{"name":"ambiently"},"homepage":"https://github.com/ambiently-work/faux","repository":{"type":"git","url":"git+https://github.com/ambiently-work/faux.git"},"bugs":{"url":"https://github.com/ambiently-work/faux/issues"},"keywords":["shell","bash","posix","sandbox","virtual-filesystem","wasm","agent"],"type":"module","main":"./src/index.ts","types":"./src/index.ts","exports":{".":"./src/index.ts","./wasm":"./src/wasm/index.ts","./wasm-binary":"./pkg/faux_wasm_bg.wasm"},"publishConfig":{"access":"public","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"},"./wasm":{"types":"./dist/wasm/index.d.ts","import":"./dist/wasm/index.js","default":"./dist/wasm/index.js"},"./wasm-binary":"./pkg/faux_wasm_bg.wasm"}},"scripts":{"shell":"bun run cli/repl.ts","wasm-demo":"bun run cli/wasm-demo.ts","docs":"bun run --cwd packages/docs dev","docs:build":"bun run --cwd packages/docs build","build":"bun run build:wasm && bun run build:ts","build:wasm":"wasm-pack build --target web --out-dir pkg","build:ts":"tsc -b --force","test":"bun test","check":"biome check .","format":"biome format --write .","clean":"rm -rf dist pkg tsconfig.tsbuildinfo","prepublishOnly":"bun run build"},"devDependencies":{"@biomejs/biome":"^2.3.0","@biomejs/js-api":"^4.0.0","@biomejs/wasm-nodejs":"^2.4.10","typescript":"^5.9.2"},"workspaces":["packages/docs"],"gitHead":"9165c4dc270620117fb5ed60283960bded6a7e55","_id":"@ambiently-work/faux@0.0.1","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-LgwbYWgegDKq0NL5XR0VnrBWoPYagBEgN1kc8b5ZDXcUKiblpo/rfU2VVqmagvdlehlEFad2KguWzjq4H2zB+w==","shasum":"61bbbc5a39f28bd82be6e3e9a44ba0e08b6eb980","tarball":"https://registry.npmjs.org/@ambiently-work/faux/-/faux-0.0.1.tgz","fileCount":493,"unpackedSize":1788513,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCnYZnvKBuu1lSs5IWQHXSZCCl4IZlm3CwiQw1MODLFpAIgHPHP45UwXS5c3SBC8Gkw/CXXbKg0KY7ujBgQbDiJzEw="}]},"_npmUser":{"name":"lucasilverentand","email":"email@lucasilverentand.com"},"directories":{},"maintainers":[{"name":"lucasilverentand","email":"email@lucasilverentand.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/faux_0.0.1_1776767922351_0.11061509157419058"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-21T10:38:42.213Z","0.0.1":"2026-04-21T10:38:42.520Z","modified":"2026-04-21T10:38:42.815Z"},"maintainers":[{"name":"lucasilverentand","email":"email@lucasilverentand.com"}],"description":"POSIX-ish shell that runs entirely in-process — no child_process, no subshell. Virtual FS, builtins, and an optional WASM-accelerated runtime.","homepage":"https://github.com/ambiently-work/faux","keywords":["shell","bash","posix","sandbox","virtual-filesystem","wasm","agent"],"repository":{"type":"git","url":"git+https://github.com/ambiently-work/faux.git"},"author":{"name":"ambiently"},"bugs":{"url":"https://github.com/ambiently-work/faux/issues"},"license":"MIT","readme":"# faux\n\nA POSIX-ish shell that runs **entirely in-process** — no `child_process`, no subshell, no OS dependency. Bring your own environment and virtual filesystem, execute real shell syntax against it, and get structured output back.\n\nDesigned for sandboxes, agents, browser REPLs, and anywhere you want shell semantics without shelling out.\n\n## Packages\n\n| Package                                                                  | npm                                                                                                                     | What it does                                             |\n| ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |\n| [`@ambiently-work/faux`](./packages/core)                               | [![npm](https://img.shields.io/npm/v/@ambiently-work/faux.svg)](https://www.npmjs.com/package/@ambiently-work/faux)                               | The `Shell`, virtual FS, builtins, env.                  |\n| [`@ambiently-work/faux-parser`](./packages/parser)                      | [![npm](https://img.shields.io/npm/v/@ambiently-work/faux-parser.svg)](https://www.npmjs.com/package/@ambiently-work/faux-parser)                 | POSIX shell grammar → AST.                               |\n| [`@ambiently-work/faux-wasm`](./packages/wasm)                          | [![npm](https://img.shields.io/npm/v/@ambiently-work/faux-wasm.svg)](https://www.npmjs.com/package/@ambiently-work/faux-wasm)                     | Rust/WASM accelerated runtime (glob, arithmetic, etc.).  |\n| [`@ambiently-work/faux-cli`](./packages/cli)                            | [![npm](https://img.shields.io/npm/v/@ambiently-work/faux-cli.svg)](https://www.npmjs.com/package/@ambiently-work/faux-cli)                       | Interactive REPL (requires Bun).                         |\n\n## Quick start\n\n```ts\nimport { Shell } from \"@ambiently-work/faux\";\n\nconst shell = new Shell({\n  user: \"luca\",\n  fs: { \"/home/luca/hello.txt\": \"hello world\\n\" },\n});\n\nconst result = await shell.run(\"cat /home/luca/hello.txt | wc -w\");\nconsole.log(result.stdout); // \"2\\n\"\n```\n\n## Development\n\nThis is a Bun workspaces monorepo.\n\n```bash\nbun install                # install all deps\nbun run test               # run every package's test suite\nbun run build              # tsc -b across publishable packages\nbun run shell              # interactive REPL\nbun run docs               # start the docs site\n```\n\n### Publishing\n\nReleases are managed by [release-please](https://github.com/googleapis/release-please). Merging a release PR cuts tags and GitHub Releases; a publish workflow then runs `bun run build` and `npm publish` for each released package using npm's [Trusted Publishing](https://docs.npmjs.com/trusted-publishers) (OIDC) — no long-lived tokens.\n\n## License\n\nMIT © ambiently\n","readmeFilename":"README.md","_rev":"1-426ceacd2a73e4556b9bf52c05860003"}