whale

Own the harness in ten minutes.

One cell, one governed door, every operating surface. Then connect your AI.

Quickstart

Install whale — one small program, checksum-verified.

$ curl -fsSL https://studio713.dev/get | sh

Create your cell — the folder that holds the business's record, rules, agents, and surfaces.

$ whale init ~/cell --name "your business"

Start it up — this runs the operator surfaces and the door on port 8787; visit http://localhost:8787/app.

$ cd ~/cell && whale up

Connect an AI assistant over MCP — add this to your assistant's MCP config and it can work your business through the door.

{
  "mcpServers": {
    "cell": {
      "command": "whale",
      "args": ["mcp", "--dir", "~/cell"]
    }
  }
}

Make it yours — edit ontology.yaml, the rulebook, and run whale publish to apply it; the schema migrates itself.

$ whale publish

Your default surfaces

With whale up running, the cell's local base is http://localhost:8787. These are views over the same harness—not separate apps with separate truth.

The typed HTTP door is POST /v1/cmd/:name. Staff and owner surfaces stay local unless you deliberately put them behind your own authenticated network boundary.

Your storefront

The customer storefront is a separate, business-owned client—not the cell's root page and not a shared SaaS theme. Whale stamps it once; from then on its brand, code, and domain are yours.

From the cell, create the storefront files. This refuses to overwrite an existing storefront.

$ whale storefront init --dir ~/cell

For local development with Node 20+, point it at the cell and open http://localhost:3330.

$ WHALE_CELL_URL=http://127.0.0.1:8787 \
  PORT=3330 node ~/cell/storefront/server.js

Make it yours in storefront/theme.js and storefront/style.js. There is no build step and whale never regenerates over your edits.

FAQ

Is it free?

The program is free to download and run during the preview. A source release is in preparation.

Does my data stay local?

Yes — your business is one folder on your machine. A connected AI sees only what the door allows, and you can use a fully local model.

Which AI assistants work?

Any MCP-capable assistant — Claude Code and others.

What if my computer dies?

Copy the folder to a backup drive. Restoring is copying it back — on any Mac or Linux machine.

Mac & Linux?

Apple silicon Macs, Linux x86-64 and arm64. One small file.

How do I get help?

Email [email protected].