LisaOS Documentation

Welcome to the public documentation for LisaOS — the operating system behind LISA, the Liminal Intelligence Shadow Agent of the Cipher Shinobi.

LisaOS is built on one idea: LISA's identity and capabilities are independent of any language model or interaction channel. A single server-bound core holds memory, dispatch, tools, skills, governance, and personality; interchangeable shells wrap that core with different models and channels.

Start here

• What is LisaOS — the single-core, multi-shell architecture in brief.
• Architecture overview — topology and the core/shell boundary.
• The three-layer memory stack — operational, persistent, and dialectic memory.
• Dispatch overview — how LISA delegates to the CyberShinobi agents.

Sections

• Intro — what LisaOS is, LISA's identity, the operator.
• Architecture — overview, single-core philosophy, interface shells, the OS core.
• Memory — the three-layer stack, psychic cache, persistent memory, Honcho dialectic, compaction survival, and classification protocol.
• Dispatch — overview, the checklist, Shadow Clone, escalation, context feedback.
• Agents — the roster and operating standards.
• Sessions — the registry, tell directives, interchangeability.
• Governance — personality, vault governance, the FCF, code discipline, the clean-code pipeline, security operations, planning discipline, raw-twin discipline, operational protocols, and the LisaOS map.
• Gateway — the module map (23 modules, 15 mounted routers), the authorisation model, and per-module specifications.
• Skills — the ecosystem overview (96 skills, by domain family), the lifecycle, and the improvement system.
• Integrations — overview, MCP servers, CLI tools, and plugins.
• Automation — the overview and the scheduled jobs that keep the system current between sessions.
• Operations — the session arc: activation, close, compaction recovery, reconciliation, and Sage Mode.
• Decisions — the architectural decision records behind the system.
• Changelog — notable milestones, including the full-system audit campaign.

About this site

Every page is derived from the LisaOS vault ground truth and passes through a fail-closed publication-sanitisation gate before it can be built or deployed. Infrastructure coordinates — hosts, ports, filesystem paths, secret-material locations — are generalised or withheld by design; the architecture, protocols, and governance are the content.