runtime-integration

Embed Optimus Agent Runtime into external applications via HTTP REST, TypeScript SDK, CLI, or MCP stdio.

3|2|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/cloga/optimus-code --skill runtime-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runtime-integration
Source: https://github.com/cloga/optimus-code/tree/main/.optimus/skills/runtime-integration
Command: npx skills add https://github.com/cloga/optimus-code --skill runtime-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a ready-to-use interface to embed Optimus agent capabilities into external applications via HTTP REST, a TypeScript SDK, CLI contracts, or MCP stdio, enabling consistent AI-driven tasks across client stacks without requiring MCP transport changes.

Core Features & Use Cases

  • HTTP REST transport for web apps and microservices, with endpoints for running, starting, status, and health
  • TypeScript SDK for Node.js apps to interact with the runtime programmatically
  • CLI JSON contract for shell automation and CI/CD pipelines
  • MCP stdio compatibility for editors (Copilot, Cursor) and warm pool shared services
  • Unified request/response envelopes and persistent results in .optimus folders

Quick Start

Install the runtime in your project and start the HTTP server to begin embedding AI agent capabilities.

Frequently Asked Questions about runtime-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I embed an AI agent runtime into a Node.js application?

You can embed an AI agent runtime into Node.js apps by using the TypeScript SDK to interact with the Optimus runtime programmatically, enabling consistent AI-driven tasks across client stacks without requiring MCP transport changes.

What is the best way to integrate AI agents into CI/CD pipelines and shell scripts?

The best way to integrate AI agents into CI/CD pipelines is via the CLI JSON contract, which provides a ready-to-use interface for shell automation and applies consistent request and response envelopes for programmatic execution.

Does the Optimus agent runtime support HTTP REST endpoints for microservices?

Yes, the Optimus agent runtime supports HTTP REST transport for web apps and microservices, providing specific endpoints for running agents, starting sessions, checking status, and monitoring health.

Can I use MCP stdio compatibility with editors like Cursor and Copilot?

Yes, you can use MCP stdio compatibility with editors like Copilot and Cursor, which supports warm pool shared services and allows editors to communicate with the runtime directly.

How do I manage persistent results and response schemas across different client stacks?

To manage persistent results across different client stacks, the runtime enforces unified request and response schemas and stores persistent outputs in dedicated .optimus folders for consistent cross-transport integration.