Agent.OS
The Agent Operating System.
One file makes any website agent-native.
|
The Ecosystem
Five layers of agent intelligence.
Nexus
Central Intelligence
Protocol
Standardized Comms
Bridge
Web Interoperability
Hive
Agent Swarm
Forge
Development Kit
.well-known/agent
{
"$schema": "https://runaos.online/schema/v1.1.json",
"version": "1.1",
"site_name": "My Awesome App",
"description": "E-commerce, booking, analytics — fully agent-native",
"authentication": {
"type": "none"
},
"capabilities": [
{
"name": "search",
"description": "Full-text search across products, posts, or bookings",
"path": "/api/agent/search",
"method": "POST",
"preferred": true,
"auth_required": false,
"input_schema": {
"type": "object",
"required": ["q"],
"properties": {
"q": { "type": "string" },
"limit": { "type": "integer", "default": 20 }
}
}
},
{
"name": "purchase",
"description": "Direct checkout using stored payment method (via AOS Nexus)",
"path": "/api/agent/checkout",
"method": "POST",
"auth_required": true
}
]
}How to Integrate
1
Create the file
Add a .agent file to your root or .well-known directory.
You can also run npx runaos@latest.
2
Define capabilities
Specify what your agent can do using the JSON schema.
3
Deploy
Push your changes. AOS indexes your node automatically.
Docs
More to come!