Lifo is a small Linux-like operating system written in TypeScript. It boots in a few milliseconds inside a browser tab or a Node.js process: a kernel, a filesystem, a bash-like shell, processes, ports and a Node.js runtime, with no VM or emulator underneath.
These docs are organized from "run it" to "how it works" to "every option".
1. Run Lifo
Where Lifo runs and how to start it in each place.
- Where Lifo runs: the four ways to use it and how to pick one
- In the browser:
@lifo-sh/corein a web page, headless or with a terminal - In Node.js: the same box in a script, a test or a server
- In your terminal:
npx lifo-sh, an interactive shell on your machine
2. Understand it
- Why Lifo: what it's for, what it isn't, how it compares
- Architecture: kernel, filesystem, shell, processes, the Node.js layer, networking
- One box, in the tab and in the cloud: where a box runs, what swaps for a service in the cloud, how Lifo Cloud is put together
- Security and isolation: what a box does and doesn't protect
- Limitations: what doesn't run, and where it differs from Linux and Node.js
- Performance: boot time and size, measured in your browser
3. Build with it
- Files, persistence and snapshots: the filesystem, keeping files, moving a box
- Servers and previews: servers in a box, and showing them in your page
- Packages:
npm,lifo install, writing a Lifo package - Python:
python3andpipin a box (CPython on WebAssembly) - An AI agent in the tab:
agent(WebLLM on WebGPU) andbrowser, a text web browser - Embedding: a terminal, file explorer and preview in your app, or the playground
- Recipes: a Vite app, an Expo app, a database, an agent loop
4. lifo.sh
- Accounts and login:
lifo login, sites, API keys - Tunnels: a public URL for a port with
lifo tunnel - Cloud boxes: move a box to Lifo Cloud and keep it running (preview)
- Services: tools that run on Lifo's servers, like native
ffmpeg(preview)
5. Reference
- Sandbox API:
@lifo-sh/core - UI components:
@lifo-sh/ui - The lifo-sh CLI
- The lifo command: inside a box
- Shell and commands
- Environment variables
6. For agents
- Lifo for coding agents: the agent skill, the docs as Markdown, prompts to copy