paperOS
A programmable computing environment built on the Runact actor runtime.
Features
- Everything is a Command: Every user action is a named command routed through the command bus
- Minimal Core: The core only contains the runtime, actor management, command routing, event routing, extension lifecycle, and capability management
- Extensions Are First-Class: Editor, terminal, Git, LSP, search, AI, and other capabilities are composable extensions
- Lua Extension System: Configuration and extensions are written in Lua — no recompilation needed for customization
- Crash Isolation: Extension failures don't crash the environment — Runact supervision restarts failed components
- Multiple UIs: The same core supports web, desktop, terminal, and remote UIs through a stable UI protocol
Installation
Usage
# Open a file
# Show help
# Show version
Configuration
Configuration is loaded from ~/.config/paperos/init.lua:
-- Basic settings
paper..
paper..
-- Register a custom command
paper..
-- Keybinding
paper..
Architecture
See docs/architecture.md for the full architecture document.
Roadmap
See docs/roadmap.md for the development roadmap.
Secret Management
See docs/secrets.md for the secure secret-management architecture (capability-based access, credential stores, redaction).
License
[License here]