01 Instance

Install creates a row in a fixed schema. It does not mutate a table per OS.

$19 is a thin store. $99 and $199 hold memory, overlay, and resets. A $19.99 lifetime unlock opens the OS. It does not create a cloud instance. Change host later. The instance stays on Agentik. The host is the mouthpiece.

Three resets exist: memory, structure, full. They wait on approve. Export, then wipe. No ghost copy.

$19: Thin store. Three official OS you choose. No overlay, no reset.
$99 and $199: Memory, overlay, and the three resets. $199 can request hosted wake.
$19.99 lifetime: Unlocks the OS. Does not provision a cloud row.

02 Projects

One OS, one store per client.

A monthly seat can open several named projects on the same OS. Each project is its own instance: memory, objects, connections, overlay, and audit never cross. Five per OS on $19, fifteen on $99, forty on $199. talk continues on the project used last. How projects work.

03 Surfaces

Every official OS and each agent declare five living surfaces.

Instructions, Memories, Skills, Routines, Integrations. Routines are declared. They run on the host after approve. They are not an always-on meter. Skills are methods the seat already knows. You do not re-explain the craft every morning.

Instructions: The standing brief for the seat. Compiled, then overlaid in private.
Memories: Fragments that should survive the next session. Forget is a real delete.
Skills: Reusable methods. Pre-mortem, interview, brief. Not a prompt pile.
Routines: Declared graphs. They wait for approve. They do not poll in the background.
Integrations: Bindings you attach when a run needs them. Not a pre-wired vendor dump.

04 Mapping

Agents store a need, not a model name.

One catalog resolves the host model. Update the file once. Every OS that tracks latest follows. The host still pays. Agentik does not take that invoice.

Need, not a model name: Packages never store Astra, Fable, or a vendor SKU as the source of truth. They store director, code, review, write, research, extract, classify, fast, or vision.
One file, every OS: Edit rankings in the catalog and bump the version. One official OS or ten thousand Studio contracts that track latest pick up the new primary. No per-OS pull request. No table per OS.
Automatic token spend: Flagship models stay on director, code, review, and hard writing. Extract, classify, and routine steps resolve to standard or fast seats. The host still pays. Agentik does not take the invoice.
Builder writes the need: Studio and the compiler map role and composition phase to a need. A coder becomes code intelligence. A Director becomes director intelligence. Members see the need, not a secret compiler package.
Host adapters and fallbacks: The resolver walks the ranking and picks the first current candidate the host can launch. Cursor, Anthropic, OpenAI, and Hermes class mappings are adapters. A missing slug falls to the next candidate.
Pin when you must freeze: track latest is the default. track pin plus a catalog id freezes a seat for a replay. A retired pin fails closed. It does not silently swap.

Nine needs

director: Holds the mission. Flagship reasoning.
code: Writes and changes software.
review: Checks the work before it stands.
write: Drafts long language.
research: Looks outward and compares.
extract: Pulls facts from what you already have.
classify: Sorts, tags, routes.
fast: Cheap steps that should not wake a flagship.
vision: Reads images when the job needs it.

Setup

Catalog: packages/core/src/intelligence-catalog.ts. Models, host slugs, cost tiers, rankings, catalogVersion.
Assignment: Each Director and agent has intelligenceNeed, intelligenceTrack (latest or pin), optional intelligencePin.
Resolver: packages/core/src/intelligence-resolver.ts. Same function for compile, Studio, MCP list_agents / open_instance, CLI, and the instance panel.
Builder: Role and B-phase map to a need. Official os.json and Studio instanceContract persist the need. Compile emits generated intelligence.json. Never hand-edit model names into packages.
Runtime: The host runs the mapped model. managedLlmFallback stays false. Agentik does not call a silent paid LLM.
Update: Edit rankings, bump catalogVersion and catalogDate, run npm test. Pins stay. Latest seats move.

Not this

A promised percentage. A live scrape. A silent paid model.

01
A promised percentage off the host bill. Prices move. Menus move. The contract is structural.
02
A live scrape of Cursor or OpenAI. v1 is the catalog file, not a crawl that can break production.
03
A second MCP or a Composio model URL. Routing is metadata for the host you already pay.
04
A Convex table per OS. Instances stay rows in a fixed schema.
05
A silent Agentik-paid model when the host cannot run a job.

05 Studio

Paid monthly plans include Studio. A lifetime unit cannot create OS.

Studio Try is a private preview instance. The compiler package is Founder-only. Marketplace and MCP hide Builder OS except the Founder seat.

Long form spend sits in Argument. The catalog file is docs/intelligence-mapping.md.

Spend System Open Studio