- /api/license`; network errors and 5xx
- * keep the last answer. Release builds refuse new runs while the licence is missing, invalid or expired; existing
- * installs get 7 days to add a key, and a key that could not be checked yet counts for 7 days.
+ * keep the last answer. Release builds refuse new runs while the licence is missing, invalid or expired; an install
+ * without a key runs free for 7 days from its first start, and a key that could not be checked yet counts for 7 days.
*/
import {
LICENSE_INVALID,
@@ -17,12 +17,11 @@ import {
type LicenseStatus,
} from "@godmode/shared";
import { COMPILED, VERSION, config } from "../config";
-import { deleteMeta, get, getMeta, setMeta } from "../db";
+import { deleteMeta, getMeta, setMeta } from "../db";
import { bus } from "../events/bus";
import { logger } from "../log";
import { audit } from "../services/audit";
import { notify } from "../services/notifications";
-import { getSettings } from "../services/settings";
import { HttpError, parseJson } from "../util";
const log = logger("license");
@@ -42,8 +41,9 @@ const META = {
verdict: "license.verdict",
/** Since when a key has waited for its first answer; kept across key changes until one is answered. */
unverifiedSince: "license.unverified_since",
+ /** The end of the free week; set once, never moved or cleared. */
graceEndsAt: "license.grace_ends_at",
- /** When this install first ran a version with licences (the grace period is decided then, once). */
+ /** When this install first ran a version with licences. */
firstStart: "license.first_start",
};
@@ -208,13 +208,13 @@ export function licenseState(): LicenseState {
let message: string | null = null;
if (blocked) {
if (status === "missing" && graceEndsAt) {
- message = `The 7 days to add a licence key ended on ${shortDate(graceEndsAt)}. Add your key or start the free trial to keep your agents working.`;
+ message = `Your 7 free days ended on ${shortDate(graceEndsAt)}. Add your licence key or start the free trial to keep your agents working.`;
} else if (status === "missing") message = "Godmode needs a licence to start new work. Add your licence key or start the 14-day free trial.";
else if (status === "unverified") message = "Godmode couldn't check your licence key for 7 days. Connect to the internet, then refresh the licence.";
else if (status === "invalid") message = refusedKeyMessage(verdict!);
else message = "Your Godmode licence has ended. Renew it or add another key to keep your agents working.";
} else if (status === "grace" && graceEndsAt) {
- message = `Add your licence key by ${shortDate(graceEndsAt)}. Until then everything works as before.`;
+ message = `Free until ${shortDate(graceEndsAt)}. Then add your licence key or start the 14-day free trial.`;
} else if (status === "unverified" && unverifiedUntil) {
message = `Your key couldn't be checked yet. Godmode accepts it until ${shortDate(unverifiedUntil)} and tries again every few hours.`;
} else if (status === "past_due") {
@@ -415,16 +415,11 @@ export function noteLicenseRefusal(what: string, err: HttpError) {
notify("warning", "Godmode needs an active licence", `${what} couldn't start. ${err.message}`, "/settings/license");
}
-/** An install that was used before this version (set up, or with chats, runs or more than the default agent). */
-function usedBefore(): boolean {
- const count = (table: string) => get<{ c: number }>(`SELECT COUNT(*) AS c FROM ${table}`)?.c ?? 0;
- return getSettings().onboardingComplete || count("runs") > 0 || count("conversations") > 0 || count("agents") > 1;
-}
-
/**
* Before anything can start a run: takes the key from `GODMODE_LICENSE` (and keeps it from child processes) — at once
- * when none is stored, after the next check when it differs from the stored one — and, on the first start with
- * licences, gives an install that was already used 7 days to add a key.
+ * when none is stored, after the next check when it differs from the stored one — and, in builds that check licences,
+ * gives the install its 7 free days once, from the first start without a key (a new install: its very first start).
+ * Restarts never extend them.
*/
export function initLicense(): void {
const fromEnv = process.env.GODMODE_LICENSE;
@@ -439,12 +434,10 @@ export function initLicense(): void {
log.info("licence key taken from GODMODE_LICENSE", { key: key.slice(-5) });
} else if (stored !== key) pendingEnvKey = key;
}
- if (!getMeta(META.firstStart)) {
- setMeta(META.firstStart, iso(clock()));
- if (!getMeta(META.key) && usedBefore()) {
- setMeta(META.graceEndsAt, iso(clock() + LICENSE_GRACE_MS));
- log.info("existing install without a licence key: 7 days to add one");
- }
+ if (!getMeta(META.firstStart)) setMeta(META.firstStart, iso(clock()));
+ if (licenseEnforced() && !getMeta(META.key) && !getMeta(META.graceEndsAt)) {
+ setMeta(META.graceEndsAt, iso(clock() + LICENSE_GRACE_MS));
+ log.info("no licence key: free for 7 days");
}
signature = JSON.stringify(licenseState());
}
diff --git a/packages/core/test/license.test.ts b/packages/core/test/license.test.ts
index c5b62cea..1c888d63 100644
--- a/packages/core/test/license.test.ts
+++ b/packages/core/test/license.test.ts
@@ -1,12 +1,11 @@
import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, test } from "bun:test";
import type { LicenseState } from "@godmode/shared";
import { setupEnv, type TestEnv } from "./fixtures/runner-harness";
-import { get, getMeta, run as sql } from "../src/db";
+import { get, getMeta, run as sql, setMeta } from "../src/db";
import { getAccessToken } from "../src/server/auth";
import { ensureDefaultAgent } from "../src/agents/service";
import { waitForRun } from "../src/runner/runner";
import { startChat } from "../src/services/conversations";
-import { updateSettings } from "../src/services/settings";
import { createRoutine } from "../src/services/routines";
import { triggerRoutine } from "../src/scheduler/scheduler";
import { listNotifications } from "../src/services/notifications";
@@ -99,46 +98,74 @@ async function putKey(key: string): Promise<{ status: number; body: LicenseState
return { status: res.status, body: await res.json() };
}
-describe("grace for installs from before licences", () => {
- test("a fresh install gets none and is gated", () => {
+describe("the free week", () => {
+ const day = (ms: number) => new Date(ms).toLocaleDateString("en-US", { month: "short", day: "numeric" });
+
+ test("a new install without a key runs free for 7 days from its first start, and restarts don't extend them", () => {
+ const firstStart = new Date(now).toISOString();
+ const ends = now + LICENSE_GRACE_MS;
initLicense();
const s = licenseState();
- expect(s.status).toBe("missing");
- expect(s.graceEndsAt).toBeNull();
- expect(s.blocked).toBe(true);
+ expect(s.status).toBe("grace");
+ expect(s.blocked).toBe(false);
+ expect(s.graceEndsAt).toBe(new Date(ends).toISOString());
+ expect(s.message).toBe(`Free until ${day(ends)}. Then add your licence key or start the 14-day free trial.`);
+ expect(() => requireLicense()).not.toThrow();
+
+ now += 3 * DAY;
+ initLicense();
+ expect(licenseState().graceEndsAt).toBe(s.graceEndsAt);
+ expect(getMeta("license.first_start")).toBe(firstStart);
+
+ now += 5 * DAY;
+ initLicense();
+ const after = licenseState();
+ expect(after.status).toBe("missing");
+ expect(after.blocked).toBe(true);
+ expect(after.graceEndsAt).toBe(s.graceEndsAt);
+ expect(after.message).toBe(`Your 7 free days ended on ${day(ends)}. Add your licence key or start the free trial to keep your agents working.`);
expect(() => requireLicense()).toThrow(LicenseRequiredError);
+ expect(getMeta("license.first_start")).toBe(firstStart);
});
- test("an install that was already used gets 7 days once, never extended", () => {
- updateSettings({ onboardingComplete: true });
- try {
- initLicense();
- const s = licenseState();
- expect(s.status).toBe("grace");
- expect(s.blocked).toBe(false);
- expect(s.graceEndsAt).toBe(new Date(now + LICENSE_GRACE_MS).toISOString());
- expect(s.message).toContain("Add your licence key by");
-
- now += 3 * DAY;
- initLicense();
- expect(licenseState().graceEndsAt).toBe(s.graceEndsAt);
-
- now += 5 * DAY;
- const after = licenseState();
- expect(after.status).toBe("missing");
- expect(after.blocked).toBe(true);
- expect(after.message).toContain("The 7 days to add a licence key ended");
- } finally {
- updateSettings({ onboardingComplete: false });
- }
+ test("an install that already has its days keeps them as they are", () => {
+ setMeta("license.first_start", new Date(now - 6 * DAY).toISOString());
+ setMeta("license.grace_ends_at", new Date(now + DAY).toISOString());
+ initLicense();
+ expect(licenseState()).toMatchObject({ status: "grace", blocked: false, graceEndsAt: new Date(now + DAY).toISOString() });
+ });
+
+ test("an older install that was refused without a key gets its 7 days from this start", () => {
+ setMeta("license.first_start", new Date(now - 20 * DAY).toISOString());
+ initLicense();
+ expect(licenseState()).toMatchObject({ status: "grace", blocked: false, graceEndsAt: new Date(now + LICENSE_GRACE_MS).toISOString() });
+ });
+
+ test("a build that doesn't check licences doesn't start the clock", () => {
+ __setLicenseEnforcedForTests(false);
+ initLicense();
+ expect(licenseState()).toMatchObject({ status: "missing", graceEndsAt: null, message: null, blocked: false });
});
- test("GODMODE_LICENSE seeds the key, and leaves the environment", () => {
+ test("GODMODE_LICENSE seeds the key, and leaves the environment; an install with a key gets no free days", () => {
process.env.GODMODE_LICENSE = ` ${KEY.toLowerCase()} `;
initLicense();
expect(process.env.GODMODE_LICENSE).toBeUndefined();
expect(getMeta("license.key")).toBe(KEY);
- expect(licenseState().status).toBe("unverified");
+ expect(licenseState()).toMatchObject({ status: "unverified", graceEndsAt: null });
+ });
+
+ test("a key that ends during the free week leaves the rest of the week", async () => {
+ initLicense();
+ const ends = now + LICENSE_GRACE_MS;
+ answer = trial();
+ await putKey(KEY);
+ answer = json({ valid: false, plan: "monthly", status: "canceled", trialEndsAt: null, renewsAt: null, cancelAtPeriodEnd: false, manageUrl: null });
+ const s = await refreshLicense();
+ expect(s).toMatchObject({ status: "expired", blocked: false });
+ expect(s.message).toBe(`This licence has ended. Everything keeps working until ${day(ends)}.`);
+ now = ends;
+ expect(licenseState()).toMatchObject({ status: "expired", blocked: true });
});
});
diff --git a/packages/shared/src/license.ts b/packages/shared/src/license.ts
index d3b4ecd0..385127a4 100644
--- a/packages/shared/src/license.ts
+++ b/packages/shared/src/license.ts
@@ -14,7 +14,7 @@ export function isLicenseKey(input: string): boolean {
/**
* - `active`, `trial`, `past_due` (Stripe still retries the payment): the key is good.
- * - `grace`: an install from before licences has 7 days to add a key.
+ * - `grace`: the free week: an install without a key runs free for 7 days from its first start.
* - `unverified`: a key that could not be checked yet; accepted for 7 days after it was entered.
* - `missing`, `invalid`, `expired`: new runs are refused (in release builds).
*/
@@ -31,7 +31,7 @@ export interface LicenseState {
trialEndsAt: ISODate | null;
renewsAt: ISODate | null;
cancelAtPeriodEnd: boolean;
- /** Existing installs: the end of the 7-day window to add a key (set once, never extended). */
+ /** The end of the free week of an install without a key (set once, never extended). */
graceEndsAt: ISODate | null;
/** The end of the window an unverified key is accepted for. */
unverifiedUntil: ISODate | null;
diff --git a/scripts/install.sh b/scripts/install.sh
index 9ab05b97..ae0ab677 100755
--- a/scripts/install.sh
+++ b/scripts/install.sh
@@ -1,10 +1,11 @@
#!/bin/sh
# Installs the standalone Godmode Bot server (`godmode`) on Linux or macOS.
#
-# curl -fsSL https://usegodmode.com/install.sh | GODMODE_LICENSE=GM-XXXXX-XXXXX-XXXXX-XXXXX sh
+# curl -fsSL https://usegodmode.com/install.sh | sh
#
# Environment:
-# GODMODE_LICENSE your license key (welcome page, invoice or billing portal) — required; also stored for `godmode serve`
+# GODMODE_LICENSE your license key (welcome page, invoice or billing portal), stored for `godmode serve`;
+# optional: Godmode runs free for 7 days without one
# GODMODE_VERSION release tag to install, e.g. v0.2.0 (default: latest)
# GODMODE_INSTALL_DIR target directory (default: ~/.local/bin)
#
@@ -67,17 +68,15 @@ if [ "$os" = linux ]; then
fi
fi
-[ -n "$LICENSE_KEY" ] || err "set GODMODE_LICENSE to your license key — get one at $SITE"
-
asset="godmode-$os-$arch"
case "$VERSION" in latest | v*) ;; *) VERSION="v$VERSION" ;; esac
-query="key=$LICENSE_KEY&version=$VERSION"
+query="version=$VERSION"
tmp=$(mktemp -d 2>/dev/null || mktemp -d -t godmode)
trap 'rm -rf "$tmp"' EXIT INT TERM
say "Downloading $asset ($VERSION)…"
-download "$SITE/download/file/$asset?$query" "$tmp/godmode" || err "download failed — check your license key ($SITE/download)"
+download "$SITE/download/file/$asset?$query" "$tmp/godmode" || err "download failed — try again, or download it from $SITE/download"
if download "$SITE/download/file/$asset.sha256?$query" "$tmp/godmode.sha256" 2>/dev/null; then
expected=$(cut -d' ' -f1 < "$tmp/godmode.sha256")
@@ -102,8 +101,8 @@ mv -f "$tmp/godmode" "$INSTALL_DIR/godmode"
installed=$("$INSTALL_DIR/godmode" version 2>/dev/null) || err "the installed binary does not run: $INSTALL_DIR/godmode"
say "Installed Godmode Bot $installed → $INSTALL_DIR/godmode"
-# The server checks the same key: store it in its data folder (GODMODE_HOME, default ~/.godmode).
-if ! "$INSTALL_DIR/godmode" license "$LICENSE_KEY" < /dev/null > /dev/null 2>&1; then
+# The server checks the key: store it in its data folder (GODMODE_HOME, default ~/.godmode).
+if [ -n "$LICENSE_KEY" ] && ! "$INSTALL_DIR/godmode" license "$LICENSE_KEY" < /dev/null > /dev/null 2>&1; then
say "warning: the license key could not be stored; add it later with: godmode license "
fi
diff --git a/scripts/release-downloads.ts b/scripts/release-downloads.ts
index c554b04e..7635a170 100644
--- a/scripts/release-downloads.ts
+++ b/scripts/release-downloads.ts
@@ -67,7 +67,9 @@ export function downloadTable(tag: string, assets: Asset[]): string {
"",
"Not sure? Macs with an M chip (M1 and newer) take **ARM64**, almost every Windows and Linux PC takes **x86-64**. Installed apps update themselves.",
"",
- `Server: \`curl -fsSL https://usegodmode.com/install.sh | GODMODE_LICENSE=GM-… sh\` or \`docker pull ghcr.io/${REPO}:${version}\`. Checksums: ${
+ "Official builds run free for 7 days, then need a Pro key. Your own build from source never asks for one.",
+ "",
+ `Server: \`curl -fsSL https://usegodmode.com/install.sh | sh\` or \`docker pull ghcr.io/${REPO}:${version}\`. Checksums: ${
assets.some((a) => a.name === "SHA256SUMS") ? `[SHA256SUMS](${url(tag, "SHA256SUMS")})` : "SHA256SUMS"
}.`,
END,
● Customers
-{key && !invalid ? 'Your download is ready' : 'Download Godmode'}
-- {key && !invalid ? 'Your license key is filled in. Check the system and download.' : 'Enter the license key from your welcome page, invoice or billing portal.'} -
+
+
-
diff --git a/packages/core/src/license/license.ts b/packages/core/src/license/license.ts
index 2834b300..88517748 100644
--- a/packages/core/src/license/license.ts
+++ b/packages/core/src/license/license.ts
@@ -3,8 +3,8 @@
*
* The key and the licence server's last answer live in meta keys `license.*` (not in Settings, which paired phones can
* read). The key is checked at start, every 6 hours and on demand against `● Download
+Download Godmode
+Free for 7 days, no card. Then add a licence key.
+ { - phone && ( -
-
+
+ ) : (
+
+
+
+
+
+
+ Send it to your computer
+Godmode runs on a Mac, Windows or Linux computer. Open this page there to download.
+
+
+
+