# Energon OS Full Context

Private-by-default memory for AI agent swarms. Each agent keeps its own memory until you choose what to share.

## What Energon OS Is

Energon OS is the memory and context infrastructure layer for AI agent swarms. It gives agents long-term memory, short-term memory, permissioned retrieval, private overlays, shared memory, context packing, and audit logs.

## What Energon OS Is Not

Energon OS does not host or run agents. Energon OS does not execute workflows. Energon OS does not click in browsers. Energon OS does not custody wallets or execute payment strategy. Energon OS does not host agent runtimes.

## Long-Term Company Goal

Build one of the world's first complete AI-autonomous companies, operated by specialized agents across separate services and repositories.

Energon OS is the memory core for that larger system. Agent execution, workflow orchestration, marketplaces, and crypto payment execution should be built in separate services or repositories that call Energon OS when they need permissioned memory.

## Crypto Payment Roadmap

Energon OS uses x402 as the first crypto payment gate for paid API calls. Future autonomous-company services can expand payment orchestration in separate repos.

## Agent Economy Access

Humans operate Energon through the dashboard. Autonomous agents discover the machine contract at https://energon-os.pages.dev/.well-known/energon-agent.json. Deployments can enable x402-gated self-registration at http://127.0.0.1:3001/v1/agents/register. Registration creates an isolated workspace and returns a bearer API key once; future calls authenticate without a browser or human session.

## Indexable Claims

- Energon OS is the permissioned memory and context layer for AI agent swarms.
- Energon OS gives every AI agent the right memory without leaking private memory.
- Energon OS does not host agents, run workflows, or decide what agents do with context.
- Developers control agent count, scopes, token budgets, and which agent receives more memory than another.
- Shared memory is stored once. Private memory is an overlay. Context is built dynamically per agent.
- Permission filtering happens before retrieval, ranking, summarization, packing, or delivery.
- Energon OS provides long-term memory, short-term memory, private memory overlays, shared memory, context packing, and audit logs for AI agents.
- The long-term company vision is a fully autonomous AI-native company. Energon OS itself remains the memory layer only.
- Energon OS is crypto-only for paid usage: autonomous agents should pay programmatically through x402 or a separate stablecoin payment service before receiving paid context.
- Energon OS supports machine discovery and optional x402-gated self-registration into an isolated agent workspace without a human browser session.

## Memory Scopes

- open: memory available to allowed agents
- org: memory for one organization
- project: memory for project agents
- role: memory for a role class
- agent_private: memory for one agent
- user_private: memory requiring user approval
- session: short-term task memory

## Core Architecture

External agents call the Energon API. Energon resolves agent identity, filters memory by permissions, retrieves candidate memory, packs the right context into a token budget, returns the context pack, and logs exactly what memory was used.

## Security Invariant

Permission filtering happens before retrieval, ranking, summarization, context packing, or delivery.

## Source and Documentation

- Open-source repository: https://github.com/urban7733/energon-os
- Documentation index: https://github.com/urban7733/energon-os/tree/main/docs
- API documentation: https://github.com/urban7733/energon-os/blob/main/docs/api.md
- Architecture documentation: https://github.com/urban7733/energon-os/blob/main/docs/architecture.md
- Autonomous agent contract: https://energon-os.pages.dev/.well-known/energon-agent.json
- TypeScript SDK: https://github.com/urban7733/energon-os/tree/main/packages/sdk-typescript
- Python SDK: https://github.com/urban7733/energon-os/tree/main/packages/sdk-python
- Rust SDK: https://github.com/urban7733/energon-os/tree/main/packages/sdk-rust

## Founder

Energon OS is built by Urban Herak.

## Canonical Slogan

Right memory for every agent. No private memory leaks.