paperos 0.2.0

A programmable editor built on the Runact actor runtime
Documentation

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

git clone <repo>
cd paperos
cargo build --release

Usage

# Open a file
paperos myfile.txt

# Show help
paperos --help

# Show version
paperos --version

Configuration

Configuration is loaded from ~/.config/paperos/init.lua:

-- Basic settings
paper.config.set("theme", "gruvbox-dark")
paper.config.set("tab_width", 4)

-- Register a custom command
paper.commands.register("greet", function()
  print("Hello from paperOS!")
end)

-- Keybinding
paper.keys.map("normal", "<leader>g", "greet")

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]