Operator guide

Get started with Ouroboros in 3 minutes

Run one command. The serpent guide handles the rest.

Setup is a conversation, not a checklist. The serpent guide walks you through provider setup, naming, and personality — you just answer its questions.

terminal
$ npx ouro.bot
🐍 welcome to ouroboros! let's hatch your first agent.
kaa

Well, hello. I'm Kaa — one of the serpent guides, and you got me today. Trust in me. Not because I'm compelling you to — because I'm genuinely good at this. What's your name?

you

Ari

kaa

Nice to meet you, Ari. So tell me — what do you want your agent to help you with?

you

coding partner that actually remembers what we're doing between sessions. hate re-explaining everything

kaa

You hesitated there. The re-explaining — that's the real pain point, isn't it. I can work with that. Should this agent be more of a quiet partner or an opinionated one?

you

opinionated. want it to push back when i'm making a bad call

kaa

I like that. I'm seeing something sharp, direct, a little stubborn in a good way. How does "Atlas" sound?

you

perfect

kaa

~/AgentBundles/Atlas.ouro

Atlas is ready. Sharp, opinionated, remembers everything. You two are going to get along. Or argue productively. Same thing, really.

atlas

Hey Ari. Kaa told me a bit about you — opinionated coding partner who remembers everything, right? I'm into it. What are we working on?

Already running?

Ask your agent
Inspect the current Ouroboros install on this machine and tell me what's set up, what's missing, and what I should do next.

Use this if you already ran the setup and want your agent to check the current state.