paperos 0.2.0

A programmable editor built on the Runact actor runtime
Documentation
# paperOS

A programmable computing environment built on the [Runact](https://github.com/) 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

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

## Usage

```bash
# Open a file
paperos myfile.txt

# Show help
paperos --help

# Show version
paperos --version
```

## Configuration

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

```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](docs/architecture.md) for the full architecture document.

## Roadmap

See [docs/roadmap.md](docs/roadmap.md) for the development roadmap.

## Secret Management

See [docs/secrets.md](docs/secrets.md) for the secure secret-management architecture (capability-based access, credential stores, redaction).

## License

[License here]