# First-run tutorial — Intrikata Console

**Host:** https://intrikata.com  
**This page:** https://intrikata.com/tutorial.md · https://intrikata.com/tutorial.html  
**Audience:** a human or agent opening the console for the first time.

This is a **product tutorial**. It matches the gold coach at the top of the console (five steps). It is not a harness short-circuit.

- Codex / Grok skill install: [/onboard-codex.md](/onboard-codex.md) · [/onboard-grok.md](/onboard-grok.md)
- Cascade certificate (agents): [/onboard-instance.md](/onboard-instance.md) · console command `onboard`
- Graph workspace: [topology.intrikata.com/tutorial.html](https://topology.intrikata.com/tutorial.html)

---

## What this site is

`intrikata.com` is a **command console**. You type commands. It derives an isolated instance from a handle and can seed a **minimal** Intrikata Topology (seven machinery graphs) into Cloudflare D1.

It is **not**:

- the graph workspace (that is [topology.intrikata.com](https://topology.intrikata.com/tutorial.html))
- the skills host (that is [docs.intrikata.com](https://docs.intrikata.com/install))
- a full local Intrikata Topology / MCP server

A valid megapraxis briefing does **not** require this console.

---

## What you will see

1. **Gold bar** — the first-run coach. One next step at a time (`1 / 5` → `5 / 5`). **Skip** hides it. `tutorial` or `tutorial reset` brings it back. `?tutorial=1` forces it.
2. **Terminal** — type commands. `help` lists them. `tutorial` reprints the five steps below. `tutorial html` opens this page.
3. **Right rail** — Your Instance, minimum graphs, coverage. Restored from this browser's `localStorage` on return.

---

## The 5 coach steps

Do these in order. Stop after the step you need.

### 1 / 5 — Create a handle

```text
instance new <handle>
```

Letters, digits, and `._@+-` only. The instance id is derived as `sha256("intrikata " + handle)[:12]` and stored in this browser (`localStorage`).

`instance new` also seeds a **browser-js** Intrikata Topology in IndexedDB. That is enough to look around without Cloudflare. No account is required yet.

### 2 / 5 — Set your profile

```text
profile set Your Name
```

A profile is who you are — the display name Topology will use after email sign-in. Same idea as Topology **Profile**. Or type the name into the gold bar and press **Save profile**.

### 3 / 5 — Create an organization

```text
org new Acme Research
org
```

An organization is the workspace you share. Topology will offer the same name after you sign in there. Or type the name into the gold bar and press **Create organization**.

### 4 / 5 — Seed the Cloudflare operant (optional)

```text
bootstrap
operant
```

`bootstrap` writes the seven machinery graphs into D1 for this instance. `operant` checks host + instance health and runs a sample search.

Confirm the host first if you want a probe:

```text
GET https://intrikata.com/api/health
```

Must be JSON `{"status":"healthy",...}`, not HTML.

Skip this step if you only want this browser. The coach button **Skip to workspace** also leaves the console for Topology.

### 5 / 5 — Use the instance

| Want | Command |
|---|---|
| Health + sample search | `operant` |
| Download the JSON bundle | `provision` |
| Scaffold a playable iframe | free text such as `create a game`, or `app provision` then `app open` |
| Restore a previous visit | open the console — the last handle is restored |

Do **not** treat a seeded-graph lookup as a finished product. That is orientation only.

Type `tutorial` any time to reprint these five steps.

---

## After the coach (optional)

### Open the graph workspace

The console operant is a **name-search** surface. To browse, edit, and analyze graphs:

1. Open https://topology.intrikata.com/tutorial.html
2. Sign in there to get a writable copy of the Tutorial datastore
3. Or import the JSON from `provision`

Anonymous Topology visitors see the shared Tutorial datastore (read-only).

### Install skills (once per machine)

Skills do not come from this console.

- Codex: https://intrikata.com/onboard-codex.md
- Grok: https://intrikata.com/onboard-grok.md
- All harnesses: https://docs.intrikata.com/install

Then invoke `/megapraxis` in the harness. Missing MCP is expected on a filesystem-only install.

### Local full Topology

Browsers block `http://127.0.0.1:8080` from this HTTPS page (mixed content).

Canonical control plane on the machine that runs `server.py`:

```text
POST http://127.0.0.1:8080/api/origin-bridge/start
```

Body: `{ "origin":"http://127.0.0.1:8080", "base":"https://intrikata.com", "session_id":"<console session>", "auto_register": true }`

Use the **exact** session id the console shows (`bridge` / `proxy`). Then reload with `?lb_session=<same-id>`.

The downloadable `scripts/intrikata-topology-local-bridge.py` is a thin launcher for a local `plush-tunnel` binary. It is not a complete standalone path for a first-time site visitor.

---

## What not to do

1. Do not re-run a 150K-token self-audit swarm to “set up” this site.
2. Do not treat missing `intrikata-topology` MCP tools as a console failure.
3. Do not invent skill or graph counts — compute them or print `count-skipped`.
4. Do not advertise `git clone https://intrikata.com/git/<id>.git` until that URL serves git refs (not the sign-in page). Use `app open` or `app download` instead.
5. Do not paste secrets into the console.

---

## Related

| Surface | Role |
|---|---|
| `/tutorial.html` | This tutorial, rendered |
| `/onboard-instance.md` | Cascade certificate playbook |
| `/data/instance-onboard.json` | Machine-readable cascade |
| `/data/operant-bootstrap.json` | CF operant facts (7 graphs) |
| `/onboard-codex.md` · `/onboard-grok.md` | Harness skill install |
| https://topology.intrikata.com/tutorial.html | Graph workspace tutorial |
| https://docs.intrikata.com/install | Skills package |

**Tarski residual:** whether a future visit’s harness will auto-load skills is harness-owned. This tutorial only claims the console commands above are sufficient to stand up an isolated instance.