# KOSMO Program for Builders

**Status**: ZOO-Certified (Zero Entropy, One Truth)
**Protocol**: v1.0 (Production)

## Overview
KOSMO is an agentic protocol program designed to accelerate any builder at any scale. It enforces strict determinism, deep research automation, and secure protocol enforcement through the **Hermios Agency**.

## Installation (MCP)
This project is designed to be installed as an MCP (Model Context Protocol) server.

1.  **Add to Claude/Cursor**:
    - Name: `kosmo`
    - Command: `uv run python hermios_gatekeeper.py`
    - Env: `HERMIOS_API=http://localhost:8000` (for local) or production URL.

2.  **Verify**:
    - Run `%hermios::{kosmo help}` in your agent chat.

## Documentation
- **[KOSMO.md](KOSMO.md)**: Full Protocol Definition & Help.
- **[GEMINI.md](~/.gemini/GEMINI.md)**: Global Rules & Mandates.

## Core Features
- **Athena**: Theoretical Verifier (ZOO Audits, Logic Verification).
- **Chiron**: Training Optimizer (ML Pipelines).
- **Chaos**: Git Agent of Chains (Version Control for Logic).

## Support
Email: info@hermios.us
