Introduction

┌──────────────────────────────────────────────────┐
│                  Terminal UI                      │  xterm.js + Tokyo Night theme
├──────────────────────────────────────────────────┤
│                    Shell                          │  bash-like interpreter
├──────────────────────────────────────────────────┤
│            Command Registry / $PATH              │  ES module command map
├───────────┬────────────┬─────────────────────────┤
│ Coreutils │ Net Cmds   │ User Packages           │  each cmd = async function
├───────────┴────────────┴─────────────────────────┤
│          Node.js Compatibility Layer             │  thin wrappers over OS APIs
├──────────────────────────────────────────────────┤
│           Virtual Filesystem (VFS)               │  in-memory + IndexedDB persistence
├──────────────────────────────────────────────────┤
│              Kernel API Layer                    │  unified browser API wrappers
├──────────────────────────────────────────────────┤
│               Browser APIs                       │  fetch, streams, OPFS, etc.
└──────────────────────────────────────────────────┘

import { Sandbox } from '@lifo-sh/core';

const sandbox = await Sandbox.create();

// Run commands
const result = await sandbox.commands.run('echo "Hello, Lifo!"');
console.log(result.stdout); // "Hello, Lifo!\n"

// Work with the filesystem
await sandbox.fs.writeFile('/tmp/greeting.txt', 'Welcome to Lifo');
const content = await sandbox.fs.readFile('/tmp/greeting.txt');
console.log(content); // "Welcome to Lifo"

// Use pipes and redirects
await sandbox.commands.run('ls /etc | grep profile > /tmp/output.txt');
const output = await sandbox.fs.readFile('/tmp/output.txt');