Module program 

Programs: OS-level installable applications for AI agents.

A program is the OS-level concept of an installable application. Like Unix has /bin programs, Oxios has programs that agents can “execute” to gain capabilities through their SKILL.md instruction files.

Structure

A program directory contains:

• program.toml - metadata (name, version, description, tools, dependencies)
• SKILL.md - instruction file (like a man page)
• optional bin/ - executables
• optional config/ - configuration files

Philosophy

Programs are READ-ONLY instruction sets. They don’t execute themselves; they provide guidelines and tools that agents consume. Think of them as man pages that come with metadata for discovery.

Structs

ArgumentDef

Argument definition for a tool

HostRequirementsCheck

Result of checking host requirements

McpServerConfig

MCP server configuration parsed from [mcp] in program.toml.

Program

Program installed in the OS

ProgramHostRequirements

Host tool requirements for a program

ProgramManager

Program manager — handles installation, uninstallation, and discovery

ProgramMeta

Program metadata — the OS-level “executable header” Like an ELF header or PE header, but for AI programs

ProgramState

Runtime state of an installed program.

ToolDef

Definition of a tool exposed by a program.

Enums

InstallSource

Installation source for a program.