Skip to main content
After installing the Worlds SDK, begin building your stateful world models. Start with vibe coding to let AI agents handle knowledge integration.

​
Vibe coding

“Vibe coding” is the practice of using AI agents—including Claude Code, Windsurf, or Cursor—to build applications through high-level intent rather than manual line-by-line coding. Worlds suits vibe coding because its state is semantic and malleable. Treat the AI output as a completed unit while maintaining a persistent, structured memory.

​
Unhobbling through integration

When you connect the @wazoo/worlds-sdk to your agent, you are explicitly unhobbling it. Instead of treating the AI as a standalone chatbot, you are onboarding it like a new human employee: giving it access to your company’s internal documents, workflows, and persistent state. By grating your agent direct tool access to a deterministic memory graph, you transition the model from relying on heavily scaffolded developer logic to its own native processing, allowing it to seamlessly navigate and collaborate in remote environments.
The Agent OS: Supplying agents with robust APIs allows them to function intelligently within swarms, observe workflows (“WatchMe” collaborative learning), and manage complete tasks efficiently.

​
The agent prompt

To help an AI agent integrate with Worlds, copy and paste the following “world-aware” prompt into your agent’s context: 
I am building an application using Worlds. Worlds are persistent, semantic
knowledge containers.

- Use the `@wazoo/worlds-sdk` SDK, which is available on JSR, to interact with
  them.
- Every World has a `worldId`.
- Store data as "Malleable Knowledge", which automatically indexes and becomes
  searchable.
- Use the `search` endpoint to retrieve context from a World.

When I ask you to "Remember X", call the Worlds SDK to store it. When I ask a
question about X, search the World for context first.

​
Agent integration

If using Claude Code, add Worlds as a custom skill by providing the OpenAPI specification.
1

Get your API key

Retrieve your key from the Worlds Console.
2

Mount the spec

Tell Claude to read https://docs.wazoo.dev/openapi.json.
3

Run the command

claude "Help me build a personal memory world for my project."

​
Best practices

  • Semantic naming: Give your Worlds descriptive names. The AI uses these names to choose the correct container for context.
  • Verbose connectors: let the AI agent handle the configuration logic when setting up connectors.
  • Context loops: Always ask the agent to “check the world” at the start of a session.