Skip to content
archived Visibility internal Owner erik@uvilo.com Approver _ Created _ Updated _

Uvilo OS README

The foundational repository project — defines the structure, conventions, and infrastructure of the entire uvilo-os repo. This is where the system was originally designed and built.

Overview

Uvilo OS is the corporate operating system of Uvilo. It contains company docs, product architecture, process documentation, agent skills, and operational learnings — all version-controlled via Git and published as a documentation site.

This project holds the original spec, requirements, research, and implementation plans for the repo itself. Most active platform work has since moved to dedicated projects in Forge/Projects/, but Uvilo OS remains the authoritative reference for how the repo is structured and how agents operate within it.

Parent Project

None — this is a top-level project.

Sub-projects

Several projects were extracted from Uvilo OS as they grew:

  • Agentic Execution — Orchestrator and autonomous multi-session execution (extracted from Spec §12)
  • Sidebar Reorg — Documentation site sidebar and project page generation
  • Libre Agents — Agent-model binding and sync architecture
  • OpenRouter — OpenRouter integration for multi-model access
  • Uvilo OS to Forge — Rename and restructure the repo around the Forge identity
  • TypeSense — Semantic search research
  • TinaCMS — Visual content editor research

Operating Guidance

  • The Spec is the single source of truth for repo conventions
  • The State tracks what has been built and what remains
  • Infrastructure plans (Railway, MCP servers) are historical but still useful for reference
  • The SKILL.md in this folder provides an agent entry point for working with the repo design