🔧 Developer Documentation

API reference, CLI tools, and integration guides

⚡ Quick Start

# Install CLI tools
npm install -g @josfox/jos @josfox/josctl @josfox/jos-cli

# Create a new service
jos-cli init my-service

# Deploy to ORCHID
josctl apply -f service.jos

🖥️ CLI Tools

jos
Core JOS runtime for executing .jos artifacts
npm install -g @josfox/jos
josctl
Kubernetes-style controller for JOS orchestration
npm install -g @josfox/josctl
jos-cli
Developer CLI for .jos workflows and project scaffolding
npm install -g @josfox/jos-cli

📡 API Reference COMING SOON

GET /api/v1/services
GET /api/v1/services/:id
POST /api/v1/services/:id/activate

📋 .jos Format

The JOS format is an open standard for AI-orchestrated artifacts. See the JOS Format Specification for full documentation.

{
  "name": "my-service",
  "version": "1.0.0",
  "canonical": "service.my-service.v1",
  "llm": {
    "summary": "What this service does",
    "intent": "What it achieves"
  }
}