Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

feat: add ASCII logo and detailed getting-started guide to CLI install script completion

0xken15e52effc1cd04
diff --git a/cli/scripts/install.sh b/cli/scripts/install.sh
index f5e05266f..4a8ed484d 100755
--- a/cli/scripts/install.sh
+++ b/cli/scripts/install.sh
@@ -12,6 +12,7 @@
# curl -fsSL https://cdn.autonomous.ai/harness/cli/install.sh | sh -s -- --host # Desktop: host requirements only
# harness login
# harness start
+# harness remote-password set # so your other machines (and `harness remote`) can reach this one
#
# Downloads the self-contained CLI bundle from the public GCS manifest and installs a `harness` command.
# Login and start are deliberately separate: login saves a native SSO session, while start launches the
@@ -666,13 +667,45 @@ if [ "$INSTALL_MODE" = "standalone" ]; then
tmux -V >/dev/null 2>&1 || { echo "✗ tmux verification failed." >&2; exit 32; }
fi
-# The explicit commands keep
-# browser SSO and long-lived daemon lifecycle understandable and scriptable.
-echo ""
-echo " harness installed."
-echo " To connect this computer, run:"
-echo " harness login"
-echo " harness start"
+# The wordmark, as the sign the install is done. `printf '%s\n'` on purpose: the art holds
+# backslashes and a backtick, which `echo` eats or interprets depending on the shell behind `sh`.
+print_logo() {
+ printf '%s\n' \
+ '' \
+ ' _' \
+ ' | |__ __ _ _ __ _ __ ___ ___ ___' \
+ ' | '"'"'_ \ / _` | '"'"'__| '"'"'_ \ / _ \/ __/ __|' \
+ ' | | | | (_| | | | | | | __/\__ \__ \' \
+ ' |_| |_|\__,_|_| |_| |_|\___||___/___/' \
+ ''
+}
+
+# The explicit commands keep browser SSO and the long-lived daemon lifecycle understandable and
+# scriptable: nothing here signs in or starts anything. Desktop mode is the app installing its own
+# CLI — the app takes the person through sign-in itself, so it gets the one line and not the guide.
+installed_version="$("$LAUNCHER" version 2>/dev/null || true)"
+if [ "$INSTALL_MODE" = "desktop" ]; then
+ echo ""
+ echo " harness${installed_version:+ $installed_version} installed."
+else
+ print_logo
+ echo " ✓ harness${installed_version:+ $installed_version} installed."
+ echo ""
+ echo " Get started — three commands, in this order:"
+ echo ""
+ echo " harness login # 1. sign in with your Autonomous account (opens a browser)"
+ echo " harness start # 2. connect this computer as a machine (runs in the background)"
+ echo " harness remote-password set # 3. let your OTHER machines reach this one (asked once, kept)"
+ echo ""
+ echo " Then, from a Harness terminal tile on any of your machines:"
+ echo ""
+ echo " harness remote # pick a machine — the tile becomes a terminal on it"
+ echo ""
+ echo " Useful:"
+ echo " harness machines # this account's machines and their ids"
+ echo " harness status # is the daemon running, and which machine this is"
+ echo " harness --help # everything else"
+fi
# 6. Make `harness` usable by NAME. We already added ~/.local/bin to your rc for NEW terminals (step 4);
# a piped `curl … | sh` can't touch the CURRENT shell's PATH, so print the one line that fixes it here
diff --git a/cli/src/scripts/install.spec.ts b/cli/src/scripts/install.spec.ts
index 22cae5380..6f4a174fc 100644
--- a/cli/src/scripts/install.spec.ts
+++ b/cli/src/scripts/install.spec.ts
@@ -31,6 +31,83 @@ const downloadToolsOf = (source: string) =>
source.indexOf(' echo "▸ Installing the Harness Node runtime'),
);
+// Steps 5 and 6 — the verification, the wordmark and the guide, and the PATH reminder — as one
+// runnable unit, from the constants down so BIN_DIR and LAUNCHER resolve the way they do in the script.
+const finaleOf = (source: string) =>
+ source.slice(source.indexOf('METADATA_URL="${HARNESS_METADATA_URL'), source.indexOf("# Shared by every download")) +
+ source.slice(source.indexOf("# 5. Final verification"));
+
+// A ~/.local/bin with a launcher that answers `version`, plus the node and tmux the verification runs.
+const installedFixture = (scratch: string) => {
+ const home = join(scratch, "home");
+ const bin = join(home, ".local", "bin");
+ mkdirSync(bin, { recursive: true });
+ writeCommand(bin, "harness", ['[ "$1" = version ] && echo 0.2.60', "exit 0"]);
+ writeCommand(scratch, "node", ["exit 0"]);
+ writeCommand(scratch, "tmux", ['echo "tmux 3.7"']);
+ return { home, node: join(scratch, "node") };
+};
+
+const runFinale = (mode: "standalone" | "desktop", pathHasBin: boolean) => {
+ const source = readFileSync(installer, "utf8");
+ const scratch = mkdtempSync(join(tmpdir(), "harness-finale-"));
+ try {
+ const { home, node } = installedFixture(scratch);
+ const bin = join(home, ".local", "bin");
+ return spawnSync("/bin/sh", ["-c", finaleOf(source)], {
+ encoding: "utf8",
+ env: {
+ ...process.env,
+ HOME: home,
+ INSTALL_MODE: mode,
+ NODE_BIN: node,
+ PATH: pathHasBin ? `${bin}:${scratch}:/usr/bin:/bin` : `${scratch}:/usr/bin:/bin`,
+ },
+ });
+ } finally {
+ rmSync(scratch, { recursive: true, force: true });
+ }
+};
+
+const LOGO = [
+ " _",
+ " | |__ __ _ _ __ _ __ ___ ___ ___",
+ " | '_ \\ / _` | '__| '_ \\ / _ \\/ __/ __|",
+ " | | | | (_| | | | | | | __/\\__ \\__ \\",
+ " |_| |_|\\__,_|_| |_| |_|\\___||___/___/",
+];
+
+describe("scripts/install.sh: what it says once it is done", () => {
+ it("ends with the wordmark and the guide — login, start, remote password, then harness remote — in that order", () => {
+ const result = runFinale("standalone", true);
+ expect(result.status).toBe(0);
+ const out = result.stdout;
+ for (const line of LOGO) expect(out).toContain(line);
+ expect(out).toContain("✓ harness 0.2.60 installed.");
+ const order = ["harness login", "harness start", "harness remote-password set", "harness remote ", "harness machines", "harness status", "harness --help"];
+ const at = order.map((command) => out.indexOf(command));
+ expect(at.every((index) => index >= 0)).toBe(true);
+ expect(at).toEqual([...at].sort((a, b) => a - b));
+ expect(out.indexOf(LOGO[1])).toBeLessThan(out.indexOf("harness login"));
+ // Every command is explained, and nothing is run: the fixture launcher only answered `version`.
+ expect(out).toContain("# 1. sign in");
+ expect(out).toContain("# 3. let your OTHER machines reach this one");
+ expect(out).not.toContain("'harness' is installed in ~/.local/bin");
+ }, 20_000);
+
+ it("the PATH reminder still comes after the guide when ~/.local/bin is not on PATH", () => {
+ const out = runFinale("standalone", false).stdout;
+ expect(out.indexOf("harness --help")).toBeLessThan(out.indexOf("'harness' is installed in ~/.local/bin"));
+ }, 20_000);
+
+ it("desktop mode gets the one line and no guide: the app takes the person through sign-in", () => {
+ const out = runFinale("desktop", true).stdout;
+ expect(out).toContain("harness 0.2.60 installed.");
+ expect(out).not.toContain("Get started");
+ expect(out).not.toContain(LOGO[1]);
+ }, 20_000);
+});
+
describe("scripts/install.sh command contract", () => {
it("rejects a legacy machine-token argument before installing", () => {
const result = spawnSync("sh", [installer, "legacy-token"], { encoding: "utf8" });