Skip to content

ChronoAIProject/Ornn

Ornn — agent-facing skill-lifecycle API

CI Latest release License  The skill lifecycle API for AI agents, not another marketplace.


What is Ornn

Ornn is an agent-facing skill-lifecycle API. AI agents call Ornn directly — over HTTPS — to manage the full lifecycle of their skills:

search → pull → install → execute → audit → build → upload → share

Closest analog: npm registry + npm CLI, fused, model-agnostic. It works for Claude, GPT, Gemini, or any custom agent runtime. Not locked to a single model.

Why we built it

Modern AI agents do real work by composing skills — packaged prompts, scripts, and tools the agent invokes on demand. As soon as you build more than one agent, the same gaps show up:

  • No shared registry. Skills live in private repos, gists, and one-off config files. There's no way for an agent to discover one it doesn't already know about.
  • Model-locked alternatives. Anthropic Skills, OpenAI custom GPTs, and Gemini Gems each ship a registry — but only for their own runtime. Skills don't cross.
  • No lifecycle. Versioning, sandboxed execution, security audit, publish — every team rebuilds these from scratch.

Ornn closes the gaps. One model-agnostic registry, one API surface, and a CLI (nyxid) every agent can drive end-to-end. The web UI at ornn.chrono-ai.fun is a thin admin layer for skill owners; the API is the product.

How it works

%%{init: {
  "theme": "base",
  "themeVariables": {
    "background": "#0B0907",
    "primaryColor": "#1A1610",
    "primaryTextColor": "#F1ECDE",
    "primaryBorderColor": "#3A3328",
    "lineColor": "#7E776B",
    "secondaryColor": "#221E16",
    "tertiaryColor": "#14110B",
    "edgeLabelBackground": "#0B0907",
    "clusterBkg": "#14110B",
    "clusterBorder": "#3A3328",
    "fontFamily": "JetBrains Mono, ui-monospace, SFMono-Regular, Menlo, monospace",
    "fontSize": "13px"
  }
}}%%
flowchart LR
    subgraph local["[ § YOUR MACHINE ]"]
        direction TB
        Agent["AI agent"]
        CLI["nyxid CLI"]
        Skill["Pulled skills"]
    end
    subgraph cloud["[ § ORNN CLOUD ]"]
        direction TB
        API["ornn-api"]
        Auth["NyxID"]
        Store[("Skill registry")]
        Sandbox["Sandbox"]
    end

    Agent -->|invoke| CLI
    CLI ==>|HTTPS| API
    API -->|verify| Auth
    API -->|r/w| Store
    API -->|exec| Sandbox
    API -.->|artifact| Agent
    Agent -->|run| Skill

    classDef ember fill:#FF7322,stroke:#C9460D,color:#14130E,stroke-width:2px,font-weight:bold
    classDef arc fill:#5BC8E8,stroke:#3A8FB8,color:#14130E,stroke-width:2px,font-weight:bold
    classDef forged fill:#1A1610,stroke:#3A3328,color:#F1ECDE,stroke-width:1.5px
    classDef storage fill:#221E16,stroke:#3A3328,color:#C9BFAD,stroke-width:1.5px

    class Agent forged
    class CLI forged
    class Skill forged
    class Sandbox forged
    class API ember
    class Auth arc
    class Store storage

    style local fill:#221E16,stroke:#3A3328,color:#F1ECDE,stroke-width:1.5px
    style cloud fill:#14110B,stroke:#3A3328,color:#F1ECDE,stroke-width:1.5px

    linkStyle 1 stroke:#FF7322,stroke-width:2.5px
Loading

Every API call is mediated by nyxid — the shared identity + brokering layer ChronoAI uses across products. The agent never holds a long-lived token: nyxid refreshes credentials transparently and brokers per-service access for each request.

Quickstart

Status: alpha. The API surface can still change before v1 — pin a release tag if you ship to production.

1. Create a NyxID account

Sign up at nyx.chrono-ai.fun with invite code NYX-2XXJI08A. Sign in with GitHub, Google, or Apple — NyxID is the identity layer that authenticates every Ornn API call. One account covers every ChronoAI service.

2. Install the Ornn agent manual into your AI agent

Open ornn-agent-manual-cli and follow the install instructions for your agent runtime (Claude Code, OpenAI Codex, Cursor, …). This skill is the operational manual Ornn ships for AI agents: once it's loaded into your agent, the agent knows how to drive the full search → pull → execute → build → upload → share lifecycle on its own — no further hand-holding required.

Partway through setup, your agent will prompt you to install nyxid — the CLI Ornn calls under the hood to broker authenticated requests. Approve the prompt; the agent finishes onboarding itself.

3. Talk to your agent

That's it. Your agent now has the full Ornn lifecycle. Try any of these in plain language — no special syntax, no flags to memorise:

  • Search the registry.

    "Find me a skill that converts CSV to JSON."

    Hits semantic + keyword search across every public skill.

  • Pull and install a skill.

    "Pull and install the skill pdf-extractor, then use it on report.pdf."

    Fetches the latest versioned artifact into your local runtime and runs it.

  • Trigger a security audit.

    "Run a security audit on the skill web-scraper."

    Kicks the AgentSeal pipeline against a published version — static analysis, sandbox probe, dependency scan.

  • Build and publish a new skill.

    "Build me a skill that summarises RSS feeds and upload it under my account."

    Drives ornn-build to generate the skill, packages it, and publishes a new version through your NyxID identity.

For the full API contract (every endpoint, every error code), see ornn.chrono-ai.fun/docs.

Community and Contributing

License

Apache License 2.0

About

Your all-in-one skills-as-a-service platform to manage your skills, auto-generate skills and use agent skills as simple as calling an API.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors