diff --git a/assets/guides/build-your-first-harness-01.png b/assets/guides/build-your-first-harness-01.png index 443180c..5d70e79 100644 Binary files a/assets/guides/build-your-first-harness-01.png and b/assets/guides/build-your-first-harness-01.png differ diff --git a/assets/guides/build-your-first-harness-02.png b/assets/guides/build-your-first-harness-02.png index bec773b..0dba989 100644 Binary files a/assets/guides/build-your-first-harness-02.png and b/assets/guides/build-your-first-harness-02.png differ diff --git a/assets/guides/build-your-first-harness-03.png b/assets/guides/build-your-first-harness-03.png index 7b9e11c..8c52e9e 100644 Binary files a/assets/guides/build-your-first-harness-03.png and b/assets/guides/build-your-first-harness-03.png differ diff --git a/assets/guides/build-your-first-harness-04.png b/assets/guides/build-your-first-harness-04.png index f9b5a51..6a41fc8 100644 Binary files a/assets/guides/build-your-first-harness-04.png and b/assets/guides/build-your-first-harness-04.png differ diff --git a/assets/guides/build-your-first-harness-05.png b/assets/guides/build-your-first-harness-05.png index c799561..8c3a36a 100644 Binary files a/assets/guides/build-your-first-harness-05.png and b/assets/guides/build-your-first-harness-05.png differ diff --git a/assets/guides/build-your-first-harness-06.png b/assets/guides/build-your-first-harness-06.png index 290e804..875e5f8 100644 Binary files a/assets/guides/build-your-first-harness-06.png and b/assets/guides/build-your-first-harness-06.png differ diff --git a/assets/guides/build-your-first-harness-07.png b/assets/guides/build-your-first-harness-07.png index d5da8dc..b01b71c 100644 Binary files a/assets/guides/build-your-first-harness-07.png and b/assets/guides/build-your-first-harness-07.png differ diff --git a/assets/guides/build-your-first-harness-dev-web.gif b/assets/guides/build-your-first-harness-dev-web.gif new file mode 100644 index 0000000..a3eb7d6 Binary files /dev/null and b/assets/guides/build-your-first-harness-dev-web.gif differ diff --git a/assets/guides/build-your-first-harness-new.gif b/assets/guides/build-your-first-harness-new.gif new file mode 100644 index 0000000..888bc68 Binary files /dev/null and b/assets/guides/build-your-first-harness-new.gif differ diff --git a/build-your-first-harness.html b/build-your-first-harness.html index fb67b08..0c2d326 100644 --- a/build-your-first-harness.html +++ b/build-your-first-harness.html @@ -52,11 +52,15 @@

Build your first harness

Requires Node 24 or newer.

TERMINAL
npx lloyal-ai new
 

The wizard defines the application boundary before it writes any code. Each choice below becomes an explicit part of the generated harness.

+
+lloyal-ai wizard running end to end, from npx lloyal-ai@latest new to the hello-harness ready screen +
The whole wizard in one pass: the five prompts covered below, then the scaffold and dependency install, ending on the ready screen.
+

Name the application

Type hello-harness and press Enter. The name becomes the project folder and npm package name.

-harness.dev at the Harness name step with hello-harness entered -
The harness is named as an application artifact, not as an endpoint or request handler.
+lloyal-ai at the Harness name step with hello-harness entered +
The harness is named as an application artifact, not as an endpoint or request handler.

A harness is the program you are building. The CLI materialises the project around that application boundary.

@@ -66,8 +70,8 @@

Name the application

Choose its surfaces

Select CLI, desktop, and web.

-harness.dev with CLI, desktop, and web selected -
CLI is always included; desktop and web mount the same harness through their own bindings.
+lloyal-ai with CLI, desktop, and web selected +
CLI is always included; desktop and web mount the same harness through their own bindings.

These are three presentations of one application contract—not three agent implementations. The intelligent procedure remains under harness/; target-specific wiring is generated under targets/.

@@ -77,8 +81,8 @@

Choose its surfaces

Choose a trunk model

Use the recommended Qwen3.5 4B weight.

-harness.dev at the trunk model step -
The recommended model is fetched and digest-verified on first run. You can also bring a local GGUF.
+lloyal-ai at the trunk model step +
The recommended model is fetched and digest-verified on first run. You can also bring a local GGUF.

The model is part of the application's execution environment. You are not configuring a client to an inference-provider endpoint.

@@ -88,8 +92,8 @@

Choose a trunk model

Choose a starting point

Select basic.

-harness.dev with the basic Wikipedia research harness selected -
basic is a compact Wikipedia research harness; research is the larger tuned recon → plan → Agents → synthesis pipeline.
+lloyal-ai with the basic Wikipedia research harness selected +
basic is a compact Wikipedia research harness; research is the larger tuned recon → plan → Agents → synthesis pipeline.

A template is editable TypeScript, not a hosted mode. It gives the harness an initial procedure and topology that you will change directly later in this guide.

@@ -99,21 +103,21 @@

Choose a starting point

Materialise the project

The CLI scaffolds the targets, vendors the signed Wikipedia App, and installs the project dependencies.

-harness.dev scaffolding hello-harness and installing dependencies -
The project is materialised from the choices above; the generated code remains yours.
+lloyal-ai scaffolding hello-harness and installing dependencies +
The project is materialised from the choices above; the generated code remains yours.

When installation completes, the wizard prints the exact command for every selected surface.

hello-harness ready with commands for CLI, desktop, and web -
hello-harness is ready to run as CLI, desktop, or web.
+
hello-harness is ready to run as CLI, desktop, or web.

Begin a Session

Enter the project and start the web target:

TERMINAL
cd hello-harness
 npm run dev:web
 
-npm run dev:web starting the resident-model host and browser client -
The web target boots the resident-model host and Vite browser client together. On first run, the host fetches and digest-verifies the model.
+lloyal-ai hello-harness running npm run dev:web: Vite serves the browser client on localhost:5173, the model fetch reaches 100 per cent, and the resident-model host comes up on ws://127.0.0.1:8787 +
The web target boots the resident-model host and Vite browser client together. On first run, the host fetches and digest-verifies the model.

Open the local address printed by Vite: http://localhost:5173/. The browser is a surface over the host; the host owns the resident model and runs the same harness.ts application contract.

When the model finishes loading and the browser connects, the application begins a Session. Submit an initial task and watch the starter procedure unfold: