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.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
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.shindex 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" ]; thentmux -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 herediff --git a/cli/src/scripts/install.spec.ts b/cli/src/scripts/install.spec.tsindex 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" });