0n Spec

   ██████╗ ███╗   ██╗
  ██╔═████╗████╗  ██║
  ██║██╔██║██╔██╗ ██║
  ████╔╝██║██║╚██╗██║
  ╚██████╔╝██║ ╚████║
   ╚═════╝ ╚═╝  ╚═══╝

What is .0n?

Just as .git revolutionized version control and .env standardized environment configuration, .0n establishes the universal standard for AI orchestration configuration.

~/.0n/
├── config.json           # Global settings
├── connections/          # Service credentials
│   ├── stripe.0n
│   ├── slack.0n
│   └── openai.0n
├── workflows/            # Automation definitions
│   └── invoice-notify.0n
├── snapshots/            # System state captures
│   └── crm-setup.0n
├── history/              # Execution logs
└── cache/                # Response cache

Every .0n file has a standard header:

{
  "$0n": {
    "type": "connection",
    "version": "1.0.0",
    "name": "Production Stripe"
  },
  "service": "stripe",
  "auth": {
    "type": "api_key",
    "credentials": { "api_key": "{{env.STRIPE_SECRET_KEY}}" }
  }
}

The philosophy: "Turn it on. It just works."

Why .0n?

File Types

Schemas

JSON Schemas for validation:

• schemas/config.json — Global configuration
• schemas/connection.json — Service connections
• schemas/workflow.json — Workflow definitions
• schemas/snapshot.json — System snapshots

Examples

Working examples of each file type:

• examples/config.0n — Global config with Anthropic provider
• examples/stripe.0n — Stripe connection with env var credentials
• examples/invoice-notify.0n — 5-step workflow: find customer, create invoice, add line item, send, notify Slack
• examples/crm-setup.0n — Full CRM snapshot with pipeline, 10 tags, custom fields, custom values, 3 workflows, email templates

CLI

Initialize, validate, and test .0n files from the command line.

Install

npm install -g 0n-spec

Commands

# Initialize ~/.0n/ directory
0n init

# Validate a .0n file
0n validate my-workflow.0n

# Validate entire directory
0n validate ~/.0n/

# Run conformance tests against examples
0n test

Library

Use programmatically in Node.js:

const { validate, parse, create, init, list, save } = require('0n-spec');

// Validate a file
const result = validate('my-workflow.0n');
// { valid: true, type: 'workflow', version: '1.0.0', errors: [], warnings: [] }

// Parse a .0n file
const workflow = parse('~/.0n/workflows/invoice-notify.0n');
// { type: 'workflow', name: 'Invoice and Notify', data: {...} }

// Create a new .0n object
const connection = create('connection', {
  name: 'My Stripe',
  service: 'stripe',
  authType: 'api_key',
  credentials: { api_key: '{{env.STRIPE_KEY}}' },
});

// Initialize ~/.0n/ directory
init();

// List all connections
const connections = list('connection');

// Save to file
save(connection, '~/.0n/connections/stripe.0n');

Template Syntax

The .0n standard uses double-brace templates:

Implementations

Building a .0n Implementation

1. Use ~/.0n/ as the config directory
2. Support the $0n header in all files
3. Validate against the JSON schemas
4. Pass conformance tests: npx 0n-spec test

Community & Unlocks

The .0n Standard grows with the 0nMCP community. Every milestone unlocks new capabilities.

• 0nmcp.com/community — Community hub
• Unlock Schedule — 7-phase roadmap to 5,000+ tools
• GitHub Discussions — Questions and ideas
• Sponsor on GitHub — Fund the next unlock

Current: Phase 0 — Foundation complete (850 tools, 53 services, 23 categories)

The 0n Network

The .0n Standard is part of the 0n Network — an open ecosystem of AI-native tools.

Contributing

We want the .0n standard to become the universal format for AI orchestration config.

Ways to contribute:

• Propose schema improvements
• Add example .0n files
• Build a .0n-compliant implementation
• Report issues or suggest features
• Star the repo

git clone https://github.com/0nork/0n-spec.git
cd 0n-spec
npm test

License

The .0n Specification is licensed under CC BY 4.0.

The CLI and library code are licensed under MIT.