Documentation

Cairo Documentation

Build with the Operational Intelligence Operating System

Welcome to the documentation for Cairo, the Operational Intelligence Operating System that enables AI to run tasks, workflows, and entire systems autonomously.

You can use Cairo to build:

AI assistants
AI agents
Operational AI systems
Multi-agent workflows
24/7 autonomous AI companies

What is Operational Intelligence?

Operational Intelligence refers to systems that analyze real-time data and enable immediate actions across operational environments. Traditional software provides information. Operational Intelligence systems monitor, analyze, and act on operations in real time.

Cairo extends this concept by enabling AI to perceive environments, plan operational decisions, execute workflows, coordinate agents, and learn continuously — transforming AI from a conversational tool into an operational system.

Perceive environments
Plan operational decisions
Execute workflows
Coordinate agents
Learn continuously

Cairo for Everyone

Cairo is designed for all users, not just developers.

Individual Users

Anyone can deploy AI assistants and operational tools directly from the Cairo platform.

  • Research assistants
  • Productivity assistants
  • Financial planning tools
  • Learning assistants
  • Personal automation systems
Browse Marketplace

Developers

Developers can build advanced AI systems using Cairo Core.

  • AI agents
  • Multi-agent systems
  • Automation frameworks
  • Operational AI systems
  • Autonomous AI companies
Download Cairo Core

Organizations

Enterprises can deploy Cairo operators to manage operational workflows continuously.

  • Enterprise automation
  • Financial operations
  • Marketing operations
  • Supply chain management
  • Infrastructure monitoring
Contact Sales

The Cairo Capability Hierarchy

Cairo systems are structured in layers of increasing capability.

Level 1

Skills

Atomic AI agents

Skills are atomic AI agents capable of performing specific tasks. Skills represent the smallest unit of operational intelligence.

Research
Data analysis
Content generation
Code writing
Contract analysis
API operations
Level 2

Plugins

Domain-specific orchestrations

Plugins are orchestrations of multiple skills designed to solve domain-specific problems. Plugins convert individual skills into domain-specific operational capabilities.

Marketing Plugin

  • Content creation
  • Campaign management
  • Analytics tracking

Legal Plugin

  • Contract analysis
  • Legal research
  • Regulatory monitoring

Finance Plugin

  • Financial analysis
  • Reporting
  • Risk monitoring
Level 3

AI Companies

Highest level of operational systems

AI companies combine multiple plugins and skills coordinated by Cairo operators. These companies can operate 24/7 autonomously, executing operational workflows continuously.

AI accounting firms
AI legal services
AI marketing agencies
AI financial advisory firms
AI recruiting companies

Cairo Architecture

Cairo is designed as a layered intelligence system. Each layer enables different capabilities.

Brain Layer

The Brain Layer provides reasoning and planning capabilities.

  • Multi-step reasoning
  • Decision planning
  • Tool orchestration
  • Operational strategy generation

Perception Layer

The Perception Layer allows Cairo to understand the environment it operates in.

  • Tools
  • APIs
  • System capabilities
  • Application interfaces

Orchestration Layer

The Orchestration Layer coordinates multiple agents and workflows.

  • Multi-agent coordination
  • Parallel task execution
  • Operational workflow planning
  • Execution monitoring

Tool Layer

The Tool Layer enables Cairo to execute actions across external systems.

  • APIs
  • Applications
  • Enterprise systems
  • Web services
  • Automation frameworks

Memory Layer

Cairo operators maintain persistent memory across operations.

  • Learning from past tasks
  • Remembering operational context
  • Improving performance over time

Observability Layer

Operational systems require monitoring and transparency.

  • Execution tracing
  • Debugging
  • Performance monitoring
  • System evaluation

Governance Layer

Autonomous systems require safety and compliance mechanisms.

  • Permission management
  • Risk controls
  • Compliance monitoring
  • Operational policy enforcement

Autonomous Company Infrastructure

Cairo introduces additional systems that enable the creation of fully autonomous operational organizations. These systems extend the core architecture of Cairo.

Together these systems allow Cairo to run 24/7 autonomous AI companies.

ACE — Autonomous Company Engine

Cairo's runtime for executing autonomous operational organizations

The Autonomous Company Engine (ACE) is Cairo's runtime system responsible for executing autonomous operational organizations. ACE orchestrates AI operators, departments, workflows, operational queues, governance systems, and safety controls. ACE converts declarative operational definitions into running AI organizations.

ACE Operational Hierarchy

1Skills
2Plugins
3Operators
4Departments
5Autonomous AI Companies

Continuous Operations

  • Monitoring marketing campaigns
  • Processing payments
  • Analyzing financial data
  • Responding to customer requests
  • Managing enterprise workflows

Governance & Safety

  • Operational policy enforcement
  • Approval mechanisms
  • Risk monitoring
  • Cost controls
  • Kill switches

Kill switches allow operators or administrators to pause or stop autonomous systems when necessary.

EIL — Event Intelligence Layer

React automatically to events across digital environments

The Event Intelligence Layer (EIL) enables Cairo to react automatically to events across digital environments. When events occur, EIL routes them to the appropriate operators, workflows, or departments.

Event Sources

  • Payment systems
  • APIs
  • Enterprise platforms
  • CRM systems
  • Emails
  • Webhooks
  • Internal system signals

Event Processing Pipeline

Event Source
Event Intelligence Layer
Event Routing
Operator or Workflow Activation
Task Execution

Example:

Payment received
Event detected
Workflow triggered
Marketing operator launches campaign

ACDL — Autonomous Company Definition Language

Declarative language for defining autonomous operational systems

ACDL is the declarative language used to define autonomous operational systems in Cairo. ACDL allows users to define operational structures using configuration files. These definitions are compiled by ACE into running operational systems.

Typical ACDL Structure

company.md
departments/marketing.md
operators/campaign_operator.md
plugins/marketing_plugin.md
skills/generate_ads.md
workflows/client_onboarding.md
events/payment_received.md

ACDL Resource Types

Company

Defines the organization and operational structure.

  • Mission
  • Departments
  • Governance policies
  • Revenue model

Departments

Group operators responsible for specific domains.

  • Marketing
  • Finance
  • Legal
  • Operations

Operators

AI workers responsible for executing tasks. Can run continuously or respond to events.

  • Campaign Operator
  • Billing Operator
  • Research Operator
  • Support Operator

Plugins

Orchestrate multiple skills into domain functionality.

  • Marketing Plugin
  • Accounting Plugin
  • Legal Plugin

Skills

Perform individual tasks.

  • Generate Ads
  • Send Invoice
  • Analyze Data
  • Draft Contract

Workflows

Define sequences of operational steps triggered by events.

  • payment_received → verify_payment → launch_campaign

Events

Trigger automation across operational systems via EIL.

  • payment_received
  • invoice_failed
  • customer_signup
  • contract_request

Policies

Enforce governance rules across operations.

  • High transaction approval rules
  • Operational safety constraints

Kill Switch

Emergency control over autonomous systems.

  • Pause operator
  • Pause department
  • Pause company
  • Safe-degrade operations
  • Hard stop system

KPIs

Measure operational performance. KPI signals can trigger corrective workflows.

  • Monthly revenue
  • Campaign ROI
  • Conversion rate
  • Customer acquisition cost

Building Your First System

Getting started with Cairo is simple.

1

Step 1Launch Cairo

Access the Cairo platform through ColomboAI.

2

Step 2Deploy Skills

Install skills or create your own capabilities.

3

Step 3Combine Skills into Plugins

Orchestrate skills into domain-specific solutions.

4

Step 4Deploy Operational Systems

Run workflows, agents, or full autonomous AI companies.

The Future of AI

The first wave focused on assistants.
The second wave focused on agents.
The next wave is Operational Intelligence.

The evolution of AI is accelerating. AI systems that run environments, execute workflows, manage systems, and operate organizations. Cairo is built to power this future.

Run environments
Execute workflows
Manage systems
Operate organizations

Contact

© 2026 ColomboAI Inc. All rights reserved.

[email protected]