Agents can't act on what they can't perceive.

Website · Quick Start · Sensors · SensorHub · Docs · Community

Watch the W2A Concept Video

Like what you see? Give us a ⭐ — every star helps more developers discover W2A.

---

What is World2Agent?

World2Agent (W2A) is an open protocol that standardizes how AI agents perceive the real world. Install a sensor, your agent gets structured, real-time data. Swap sensors freely — they all speak the same schema.

W2A isn't a product. It's an open protocol and an invitation. We built the first sensors — the real breakthroughs will come from the community.

→ Why W2A? Full story

Architecture

World → Sensor → Agent

Sensors watch data sources and emit structured data following W2A Protocol. Your agent receives signals and decides what to do.

→ Signal format spec · Architecture deep dive

Quick Start

The fastest way to feel W2A is with Claude Code. In an active session, install the world2agent plugin:

/plugin marketplace add machinepulse-ai/world2agent-plugins
/plugin install world2agent@world2agent-plugins
/reload-plugins

Add a sensor — for example, Hacker News:

/world2agent:sensor-add @world2agent/sensor-hackernews

Restart Claude Code with the plugin channel loaded so sensor signals flow into your session:

claude --dangerously-load-development-channels plugin:world2agent@world2agent-plugins

Security — install only sensors you trust. A sensor's signals drive what your agent perceives and does, so an untrusted sensor is effectively an untrusted instruction source. Stick to open-source sensors from authors you trust, and review the code first.

Or pipe directly to any agent runtime — no plugin needed:

w2a-sensor-hackernews | your-agent

Building your own agent? See the developer quick start for the SDK code path.

→ Full guide · Multi-sensor · SensorHub

Sensors

SensorHub

Every sensor is a standard npm package. SensorHub is the discovery layer on top — browse the catalog at world2agent.ai/hub, or search npm directly:

npm search w2a-sensor
npm install @world2agent/sensor-hackernews

→ SensorHub guide

Missing a sensor?

Build your own in ~50 lines. The build-w2a-sensor skill walks an AI coding agent through discovery, signal design, scaffolding, and the install recipe.

Once it's ready, ship it to npm:

npm publish

That's all it takes to share your sensor with the world — once published, it's installable by every W2A agent everywhere, and SensorHub indexes it for discovery.

Roadmap

• Graph layer — compose and enrich signals from multiple sensors before they reach your agent. → RFC

Contributing

• 🔧 Build a sensor — npm publish and it's live

• 🐛 Report bugs — open an issue

• 💡 Suggest a sensor — Discussions

→ Contributing guide

Community

Website · X / Twitter · YouTube

License

Apache 2.0

---

Built by MachinePulse · Open source, open protocol, open invitation.