create-terse 0.0.1

package/LICENSE.md

@@ -0,0 +1,83 @@
+# License
+
+Portions of this software are licensed as follows:
+
+- Content of branches other than the main branch (i.e. "main") are not licensed.
+- All third party components incorporated into the Terse Software are licensed under the original license
+  provided by the owner of the applicable component.
+- Content outside of the above mentioned files or restrictions is available under the "Sustainable Use
+  License" as defined below.
+
+## Sustainable Use License
+
+Version 1.0
+
+### Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license
+to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+### Limitations
+
+You may use or modify the software only for your own internal business purposes or for non-commercial or
+personal use. You may distribute the software or provide it to others only if you do so free of charge for
+non-commercial purposes. You may not alter, remove, or obscure any licensing, copyright, or other notices of
+the licensor in the software. Any use of the licensor’s trademarks is subject to applicable law.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor can license, or becomes able to
+license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case
+subject to the limitations and conditions in this license. This license does not cover any patent claims that
+you cause to be infringed by modifications or additions to the software. If you or your company make any
+written claim that the software infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company makes such a claim, your patent
+license ends immediately for work on behalf of your company.
+
+### Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these
+terms. If you modify the software, you must include in any modified copies of the software a prominent notice
+stating that you have modified the software.
+
+### No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in these terms.
+
+### Termination
+
+If you use the software in violation of these terms, such use is not licensed, and your license will
+automatically terminate. If the licensor provides you with a notice of your violation, and you cease all
+violation of this license no later than 30 days after you receive that notice, your license will be reinstated
+retroactively. However, if you violate these terms after such reinstatement, any additional violation of these
+terms will cause your license to terminate automatically and permanently.
+
+### No Liability
+
+As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will
+not be liable to you for any damages arising out of these terms or the use or nature of the software, under
+any kind of legal claim.
+
+### Definitions
+
+The “licensor” is the entity offering these terms.
+
+The “software” is the software the licensor makes available under these terms, including any portion of it.
+
+“You” refers to the individual or entity agreeing to these terms.
+
+“Your company” is any legal entity, sole proprietorship, or other kind of organization that you work for, plus
+all organizations that have control over, are under the control of, or are under common control with that
+organization. Control means ownership of substantially all the assets of an entity, or the power to direct its
+management and policies by vote, contract, or otherwise. Control can be direct or indirect.
+
+“Your license” is the license granted to you for the software under these terms.
+
+“Use” means anything you do with the software requiring your license.
+
+“Trademark” means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,55 @@
+# create-terse
+
+Scaffold and launch a self-hosted [Terse](https://useterse.ai) instance with one command.
+
+Terse is a code-first AI workflow platform. You write workflows in TypeScript, generate a typed SDK from your connected integrations, and deploy them. Full docs at [docs.useterse.ai](https://docs.useterse.ai).
+
+## Usage
+
+```bash
+npm create terse
+```
+
+or
+
+```bash
+npx create-terse
+```
+
+This walks you through a short setup, writes a `docker-compose.yml` and `.env` into a target directory, pulls the Terse image, starts the services (Postgres, backend, frontend), and installs the `terse` CLI pointed at your new instance.
+
+## Options
+
+```bash
+npx create-terse [options]
+```
+
+| Option | Description |
+|---|---|
+| `-y`, `--non-interactive` | Skip prompts and use defaults (auto-enabled when stdin/stdout is not a TTY). |
+| `--target <dir>` | Target directory (default: `./terse`). |
+| `--frontend-url <url>` | Frontend URL as seen from your browser (default: `http://localhost:5173`). |
+| `--backend-url <url>` | Backend URL as seen from your browser (default: `http://localhost:3001`). |
+| `--no-open` | Don't open the frontend in your browser when setup completes. |
+| `-h`, `--help` | Show help. |
+
+### Examples
+
+```bash
+npm create terse
+npx create-terse -y
+npx create-terse -y --target ./my-terse --backend-url http://localhost:3001
+```
+
+## Requirements
+
+- Node.js >= 18
+- Docker with Compose v2 (`docker compose`)
+
+## After setup
+
+The generated `README.md` in your target directory covers daily operations (logs, upgrades, backups, troubleshooting). See the [self-hosting guide](https://docs.useterse.ai/self-hosting) for the full walkthrough.
+
+## License
+
+See [LICENSE.md](./LICENSE.md).

package/dist/index.js

@@ -0,0 +1,305 @@
+#!/usr/bin/env node
+import { cancel, intro, isCancel, log, outro, spinner, text } from "@clack/prompts";
+import chalk from "chalk";
+import { execSync, spawn } from "node:child_process";
+import { exec } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import fs from "node:fs/promises";
+import net from "node:net";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = path.resolve(SCRIPT_DIR, "../templates");
+const DEFAULTS = {
+    targetDir: "./terse",
+    frontendUrl: "http://localhost:5173",
+    backendUrl: "http://localhost:3001"
+};
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        printHelp();
+        return;
+    }
+    const nonInteractive = args.nonInteractive || !process.stdin.isTTY || !process.stdout.isTTY;
+    intro(chalk.bold(chalk.magenta(" Terse self-host setup ")));
+    if (nonInteractive)
+        log.info("Running non-interactively. Pass --target / --frontend-url / --backend-url to override defaults.");
+    const targetDir = await promptOr(nonInteractive, args.targetDir, "Where should we set up Terse?", DEFAULTS.targetDir);
+    const resolved = path.resolve(targetDir);
+    await fs.mkdir(resolved, { recursive: true });
+    await fs.copyFile(path.join(TEMPLATES_DIR, "docker-compose.yml"), path.join(resolved, "docker-compose.yml"));
+    await fs.copyFile(path.join(TEMPLATES_DIR, "README.md"), path.join(resolved, "README.md"));
+    const frontendUrl = await promptOr(nonInteractive, args.frontendUrl, "Frontend URL (as seen from your browser)", DEFAULTS.frontendUrl);
+    const backendUrl = await promptOr(nonInteractive, args.backendUrl, "Backend URL (as seen from your browser)", DEFAULTS.backendUrl);
+    const postgresPort = await findFreePort(5432);
+    if (postgresPort !== 5432) {
+        log.warn(`Port 5432 is taken on this machine, exposing the Terse Postgres container on ${postgresPort} instead.`);
+    }
+    const frontendPort = hostPortFromUrl(frontendUrl);
+    const backendPort = hostPortFromUrl(backendUrl);
+    await writeEnv(resolved, { frontendUrl, backendUrl, frontendPort, backendPort, postgresPort });
+    log.success(`Wrote .env (edit ${path.join(targetDir, ".env")} to tweak ports, URLs, or secrets)`);
+    await runStepStreaming("Pulling Terse image (first run downloads ~500MB)", "docker compose pull", resolved);
+    await runStep("Starting Terse services", "docker compose up -d", resolved);
+    await waitForBackend(backendUrl);
+    await installTerseCli();
+    await pointTerseCliAtLocal({ frontendUrl, backendUrl });
+    printNextSteps({ frontendUrl });
+    outro(chalk.green(`Setup complete. Terse is running at ${chalk.bold(frontendUrl)}.`));
+    if (!nonInteractive && !args.noOpen) {
+        await openInBrowser(frontendUrl);
+    }
+}
+async function openInBrowser(url) {
+    const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    try {
+        await execAsync(`${opener} ${shellEscape(url)}`);
+    }
+    catch {
+        // browser open is a nice-to-have; if it fails the user already has the URL in the outro
+    }
+}
+function printNextSteps(args) {
+    log.message([
+        chalk.bold("Next steps:"),
+        `  1. Open ${chalk.cyan(args.frontendUrl)} ${chalk.dim("to bootstrap your single admin user.")}`,
+        `  2. ${chalk.cyan("terse init my-job")}    ${chalk.dim("# scaffold your first job (CLI is installed and pointed at your local backend).")}`,
+        "",
+        chalk.dim("See `README.md` in this folder for daily ops (logs, upgrades, backups, troubleshooting)."),
+        chalk.dim("Run `terse target` any time to see which backend the CLI is pointing at.")
+    ].join("\n"));
+}
+async function installTerseCli() {
+    if (commandExists("terse")) {
+        log.info("terse CLI already installed, skipping global install");
+        return;
+    }
+    await runStep("Installing terse CLI globally (npm i -g terse-cli)", "npm install -g terse-cli", process.cwd());
+}
+async function pointTerseCliAtLocal(urls) {
+    if (!commandExists("terse")) {
+        log.warn("terse CLI not on PATH, skipping `terse target use`. Run it manually once installed.");
+        return;
+    }
+    const cmd = `terse target use --backend-url ${shellEscape(urls.backendUrl)} --frontend-url ${shellEscape(urls.frontendUrl)} --yes`;
+    await runStep(`Pointing terse CLI at ${urls.backendUrl}`, cmd, process.cwd());
+}
+function commandExists(name) {
+    try {
+        execSync(`command -v ${name}`, { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function writeEnv(targetDir, config) {
+    const socketUrl = toWebSocketUrl(config.backendUrl);
+    const lines = [
+        "# Terse self-host config. Edit values then `docker compose up -d` to apply.",
+        "",
+        "# ── URLs (what your browser sees) ─────────────────────────────",
+        `FRONTEND_URL=${config.frontendUrl}`,
+        `BACKEND_URL=${config.backendUrl}`,
+        "",
+        "# ── Host ports (must match the ports in the URLs above) ───────",
+        `FRONTEND_PORT=${config.frontendPort}`,
+        `BACKEND_PORT=${config.backendPort}`,
+        "",
+        "# ── Postgres ──────────────────────────────────────────────────",
+        "POSTGRES_USER=postgres",
+        "POSTGRES_PASSWORD=postgres",
+        "POSTGRES_DB=terse",
+        `POSTGRES_PORT=${config.postgresPort}`,
+        "",
+        "# ── Secrets (rotate by replacing the values) ──────────────────",
+        `JWT_SECRET=${randomBytes(32).toString("base64url")}`,
+        `LOCAL_SECRETS_ENCRYPTION_KEY=${randomBytes(32).toString("base64url")}`,
+        "",
+        "# ── Frontend (must match BACKEND_URL above) ───────────────────",
+        `VITE_API_BASE_URL=${config.backendUrl}`,
+        `VITE_BACKEND_REDIRECT_URL=${config.backendUrl}`,
+        `VITE_SOCKET_URL=${socketUrl}`,
+        "",
+        "# ── Internal backend URL (how the backend container reaches itself) ─",
+        "# Job runs talk to the backend from inside the container, where it",
+        "# always listens on 3001. This is NOT the host port in BACKEND_URL.",
+        "# Leave as-is unless you change the backend's in-container listen port.",
+        "INTERNAL_BACKEND_URL=http://localhost:3001",
+        "",
+        "# ── Runtime ───────────────────────────────────────────────────",
+        "NODE_ENV=development",
+        "",
+        "# ── Image (uncomment to pin to a specific tag) ────────────────",
+        "# TERSE_IMAGE=us-central1-docker.pkg.dev/fluid-analogy-473415-c2/public/terse",
+        ""
+    ];
+    await fs.writeFile(path.join(targetDir, ".env"), lines.join("\n"));
+}
+function toWebSocketUrl(httpUrl) {
+    const url = new URL(httpUrl);
+    url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+    return url.toString().replace(/\/$/, "");
+}
+function hostPortFromUrl(httpUrl) {
+    const url = new URL(httpUrl);
+    if (url.port)
+        return Number(url.port);
+    return url.protocol === "https:" ? 443 : 80;
+}
+async function promptOr(nonInteractive, override, message, placeholder) {
+    if (override !== undefined) {
+        log.info(`${message} ${chalk.dim(`→ ${override}`)}`);
+        return override;
+    }
+    if (nonInteractive) {
+        log.info(`${message} ${chalk.dim(`→ ${placeholder} (default)`)}`);
+        return placeholder;
+    }
+    const result = await text({ message, placeholder, defaultValue: placeholder });
+    if (isCancel(result)) {
+        cancel("Cancelled.");
+        process.exit(0);
+    }
+    return result;
+}
+function parseArgs(argv) {
+    const out = { nonInteractive: false, noOpen: false, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = () => {
+            const v = argv[++i];
+            if (v === undefined)
+                throw new Error(`Missing value for ${arg}`);
+            return v;
+        };
+        const valueOf = (flag) => {
+            const eq = arg.indexOf("=");
+            return eq >= 0 ? arg.slice(eq + 1) : next();
+        };
+        if (arg === "-y" || arg === "--yes" || arg === "--non-interactive")
+            out.nonInteractive = true;
+        else if (arg === "-h" || arg === "--help")
+            out.help = true;
+        else if (arg === "--target" || arg.startsWith("--target="))
+            out.targetDir = valueOf(arg);
+        else if (arg === "--frontend-url" || arg.startsWith("--frontend-url="))
+            out.frontendUrl = valueOf(arg);
+        else if (arg === "--backend-url" || arg.startsWith("--backend-url="))
+            out.backendUrl = valueOf(arg);
+        else if (arg === "--no-open")
+            out.noOpen = true;
+        else
+            throw new Error(`Unknown argument: ${arg}. Run with --help for usage.`);
+    }
+    return out;
+}
+function printHelp() {
+    const lines = [
+        chalk.bold("create-terse — scaffold a self-hosted Terse instance"),
+        "",
+        chalk.bold("Usage:"),
+        "  npx create-terse [options]",
+        "",
+        chalk.bold("Options:"),
+        "  -y, --non-interactive       Skip prompts and use defaults (also auto-enabled when stdin/stdout is not a TTY)",
+        `  --target <dir>              Target directory (default: ${DEFAULTS.targetDir})`,
+        `  --frontend-url <url>        Frontend URL (default: ${DEFAULTS.frontendUrl})`,
+        `  --backend-url <url>         Backend URL (default: ${DEFAULTS.backendUrl})`,
+        "  --no-open                   Skip opening the frontend in your browser when setup completes",
+        "  -h, --help                  Show this help",
+        "",
+        chalk.bold("Examples:"),
+        "  npx create-terse",
+        "  npx create-terse -y",
+        "  npx create-terse -y --target ./my-terse --backend-url http://localhost:3001"
+    ];
+    console.log(lines.join("\n"));
+}
+async function runStep(label, command, cwd) {
+    const s = spinner();
+    s.start(label);
+    try {
+        await execAsync(command, { cwd });
+        s.stop(`${label} ✓`);
+    }
+    catch (err) {
+        s.stop(`${label} ✗`);
+        const message = err instanceof Error ? err.message : String(err);
+        const stdout = err.stdout ?? "";
+        const stderr = err.stderr ?? "";
+        throw new Error([message, stdout, stderr].filter(Boolean).join("\n"));
+    }
+}
+async function runStepStreaming(label, command, cwd) {
+    log.info(label);
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, { cwd, stdio: "inherit", shell: true });
+        child.on("exit", code => {
+            if (code === 0) {
+                log.success(`${label} ✓`);
+                resolve();
+            }
+            else {
+                reject(new Error(`${label} failed with exit code ${code}`));
+            }
+        });
+        child.on("error", reject);
+    });
+}
+function shellEscape(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+async function findFreePort(preferred) {
+    const candidates = [preferred, 54322, 54323, 54324, 54325];
+    for (const port of candidates) {
+        if (await isPortFree(port))
+            return port;
+    }
+    throw new Error("Could not find a free TCP port for Postgres");
+}
+async function isPortFree(port) {
+    const v4Busy = await tryConnect("127.0.0.1", port);
+    const v6Busy = await tryConnect("::1", port);
+    return !v4Busy && !v6Busy;
+}
+function tryConnect(host, port) {
+    return new Promise(resolve => {
+        const socket = net.connect({ host, port });
+        const done = (ok) => {
+            socket.removeAllListeners();
+            socket.destroy();
+            resolve(ok);
+        };
+        socket.once("connect", () => done(true));
+        socket.once("error", () => done(false));
+    });
+}
+async function waitForBackend(backendUrl) {
+    const s = spinner();
+    s.start(`Waiting for backend at ${backendUrl}`);
+    const deadline = Date.now() + 120_000;
+    while (Date.now() < deadline) {
+        try {
+            const response = await fetch(backendUrl, { signal: AbortSignal.timeout(2000) });
+            if (response.status < 500) {
+                s.stop(`Backend is responding ✓`);
+                return;
+            }
+        }
+        catch {
+            // not ready yet
+        }
+        await new Promise(resolve => setTimeout(resolve, 1000));
+    }
+    s.stop(`Backend did not become ready in 120s ✗`);
+    throw new Error(`Backend at ${backendUrl} never started responding. Check logs with: docker compose logs backend`);
+}
+main().catch(err => {
+    log.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACnF,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjC,OAAO,GAAG,MAAM,UAAU,CAAA;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;AAEjC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;AAE9D,MAAM,QAAQ,GAAG;IACb,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,uBAAuB;IACpC,UAAU,EAAE,uBAAuB;CAC7B,CAAA;AAWV,KAAK,UAAU,IAAI;IACf,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,SAAS,EAAE,CAAA;QACX,OAAM;IACV,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAA;IAE3F,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAA;IAC3D,IAAI,cAAc;QAAE,GAAG,CAAC,IAAI,CAAC,iGAAiG,CAAC,CAAA;IAE/H,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,EAAE,+BAA+B,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;IACrH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAExC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAA;IAC5G,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAA;IAE1F,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,WAAW,EAAE,0CAA0C,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAA;IACtI,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,UAAU,EAAE,yCAAyC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAA;IAElI,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;IAC7C,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,gFAAgF,YAAY,WAAW,CAAC,CAAA;IACrH,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IACjD,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,CAAC,CAAA;IAC/C,MAAM,QAAQ,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAA;IAC9F,GAAG,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,oCAAoC,CAAC,CAAA;IAEjG,MAAM,gBAAgB,CAAC,kDAAkD,EAAE,qBAAqB,EAAE,QAAQ,CAAC,CAAA;IAC3G,MAAM,OAAO,CAAC,yBAAyB,EAAE,sBAAsB,EAAE,QAAQ,CAAC,CAAA;IAC1E,MAAM,cAAc,CAAC,UAAU,CAAC,CAAA;IAEhC,MAAM,eAAe,EAAE,CAAA;IACvB,MAAM,oBAAoB,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAA;IAEvD,cAAc,CAAC,EAAE,WAAW,EAAE,CAAC,CAAA;IAC/B,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,uCAAuC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;IAErF,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,aAAa,CAAC,WAAW,CAAC,CAAA;IACpC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAA;IAC3G,IAAI,CAAC;QACD,MAAM,SAAS,CAAC,GAAG,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACpD,CAAC;IAAC,MAAM,CAAC;QACL,wFAAwF;IAC5F,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,IAA6B;IACjD,GAAG,CAAC,OAAO,CACP;QACI,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC;QACzB,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,sCAAsC,CAAC,EAAE;QAChG,QAAQ,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,iFAAiF,CAAC,EAAE;QAC5I,EAAE;QACF,KAAK,CAAC,GAAG,CAAC,0FAA0F,CAAC;QACrG,KAAK,CAAC,GAAG,CAAC,0EAA0E,CAAC;KACxF,CAAC,IAAI,CAAC,IAAI,CAAC,CACf,CAAA;AACL,CAAC;AAED,KAAK,UAAU,eAAe;IAC1B,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAA;QAChE,OAAM;IACV,CAAC;IACD,MAAM,OAAO,CAAC,oDAAoD,EAAE,0BAA0B,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;AAClH,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAiD;IACjF,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAA;QAC/F,OAAM;IACV,CAAC;IACD,MAAM,GAAG,GAAG,kCAAkC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAA;IAClI,MAAM,OAAO,CAAC,yBAAyB,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;AACjF,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IAC/B,IAAI,CAAC;QACD,QAAQ,CAAC,cAAc,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QACjD,OAAO,IAAI,CAAA;IACf,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAA;IAChB,CAAC;AACL,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,SAAiB,EAAE,MAAoH;IAC3J,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG;QACV,6EAA6E;QAC7E,EAAE;QACF,kEAAkE;QAClE,gBAAgB,MAAM,CAAC,WAAW,EAAE;QACpC,eAAe,MAAM,CAAC,UAAU,EAAE;QAClC,EAAE;QACF,kEAAkE;QAClE,iBAAiB,MAAM,CAAC,YAAY,EAAE;QACtC,gBAAgB,MAAM,CAAC,WAAW,EAAE;QACpC,EAAE;QACF,kEAAkE;QAClE,wBAAwB;QACxB,4BAA4B;QAC5B,mBAAmB;QACnB,iBAAiB,MAAM,CAAC,YAAY,EAAE;QACtC,EAAE;QACF,kEAAkE;QAClE,cAAc,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrD,gCAAgC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;QACvE,EAAE;QACF,kEAAkE;QAClE,qBAAqB,MAAM,CAAC,UAAU,EAAE;QACxC,6BAA6B,MAAM,CAAC,UAAU,EAAE;QAChD,mBAAmB,SAAS,EAAE;QAC9B,EAAE;QACF,wEAAwE;QACxE,oEAAoE;QACpE,qEAAqE;QACrE,yEAAyE;QACzE,4CAA4C;QAC5C,EAAE;QACF,kEAAkE;QAClE,sBAAsB;QACtB,EAAE;QACF,kEAAkE;QAClE,+EAA+E;QAC/E,EAAE;KACL,CAAA;IACD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACtE,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACnC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5B,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;IACzD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAC5C,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACpC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5B,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACrC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/C,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,cAAuB,EAAE,QAA4B,EAAE,OAAe,EAAE,WAAmB;IAC/G,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAA;QACpD,OAAO,QAAQ,CAAA;IACnB,CAAC;IACD,IAAI,cAAc,EAAE,CAAC;QACjB,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,WAAW,YAAY,CAAC,EAAE,CAAC,CAAA;QACjE,OAAO,WAAW,CAAA;IACtB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAA;IAC9E,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,MAAM,CAAC,YAAY,CAAC,CAAA;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;IACD,OAAO,MAAgB,CAAA;AAC3B,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC7B,MAAM,GAAG,GAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,MAAM,IAAI,GAAG,GAAW,EAAE;YACtB,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;YACnB,IAAI,CAAC,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAA;YAChE,OAAO,CAAC,CAAA;QACZ,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE;YACrC,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAC3B,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/C,CAAC,CAAA;QACD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,mBAAmB;YAAE,GAAG,CAAC,cAAc,GAAG,IAAI,CAAA;aACxF,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;aACrD,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;aACnF,IAAI,GAAG,KAAK,gBAAgB,IAAI,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;YAAE,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;aACjG,IAAI,GAAG,KAAK,eAAe,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAAE,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;aAC9F,IAAI,GAAG,KAAK,WAAW;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAA;;YAC1C,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,8BAA8B,CAAC,CAAA;IAChF,CAAC;IACD,OAAO,GAAG,CAAA;AACd,CAAC;AAED,SAAS,SAAS;IACd,MAAM,KAAK,GAAG;QACV,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC;QAClE,EAAE;QACF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;QACpB,8BAA8B;QAC9B,EAAE;QACF,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;QACtB,gHAAgH;QAChH,4DAA4D,QAAQ,CAAC,SAAS,GAAG;QACjF,wDAAwD,QAAQ,CAAC,WAAW,GAAG;QAC/E,uDAAuD,QAAQ,CAAC,UAAU,GAAG;QAC7E,8FAA8F;QAC9F,8CAA8C;QAC9C,EAAE;QACF,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;QACvB,oBAAoB;QACpB,uBAAuB;QACvB,+EAA+E;KAClF,CAAA;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACjC,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,KAAa,EAAE,OAAe,EAAE,GAAW;IAC9D,MAAM,CAAC,GAAG,OAAO,EAAE,CAAA;IACnB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACd,IAAI,CAAC;QACD,MAAM,SAAS,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;QACjC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAA;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAA;QACpB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,MAAM,MAAM,GAAI,GAA2B,CAAC,MAAM,IAAI,EAAE,CAAA;QACxD,MAAM,MAAM,GAAI,GAA2B,CAAC,MAAM,IAAI,EAAE,CAAA;QACxD,MAAM,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACzE,CAAC;AACL,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAe,EAAE,GAAW;IACvE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACf,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACpE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE;YACpB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACb,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,CAAA;gBACzB,OAAO,EAAE,CAAA;YACb,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,0BAA0B,IAAI,EAAE,CAAC,CAAC,CAAA;YAC/D,CAAC;QACL,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;AACN,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAC9B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAA;AAC9C,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,SAAiB;IACzC,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IAC1D,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;IAC3C,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;AAClE,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IAClC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;IAClD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC5C,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAA;AAC7B,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,IAAY;IAC1C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QACzB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,MAAM,IAAI,GAAG,CAAC,EAAW,EAAE,EAAE;YACzB,MAAM,CAAC,kBAAkB,EAAE,CAAA;YAC3B,MAAM,CAAC,OAAO,EAAE,CAAA;YAChB,OAAO,CAAC,EAAE,CAAC,CAAA;QACf,CAAC,CAAA;QACD,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACxC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;AACN,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,UAAkB;IAC5C,MAAM,CAAC,GAAG,OAAO,EAAE,CAAA;IACnB,CAAC,CAAC,KAAK,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAA;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA;IACrC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC/E,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACxB,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;gBACjC,OAAM;YACV,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,gBAAgB;QACpB,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;IAC3D,CAAC;IACD,CAAC,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAA;IAChD,MAAM,IAAI,KAAK,CAAC,cAAc,UAAU,yEAAyE,CAAC,CAAA;AACtH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACf,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "create-terse",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "Scaffold and launch a self-hosted Terse instance with one command.",
+  "keywords": [
+    "terse",
+    "create-terse",
+    "scaffold",
+    "self-hosted",
+    "ai",
+    "workflow",
+    "docker-compose"
+  ],
+  "license": "SEE LICENSE IN LICENSE.md",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TerseAI/Terse.git",
+    "directory": "packages/create-terse"
+  },
+  "homepage": "https://docs.useterse.ai",
+  "bugs": {
+    "url": "https://github.com/TerseAI/Terse/issues"
+  },
+  "bin": {
+    "create-terse": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "chalk": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch --preserveWatchOutput",
+    "install-global": "npm run build && npm link",
+    "format": "pnpm exec prettier --config ../../.prettierrc --write \"src/**/*.ts\"",
+    "format:check": "pnpm exec prettier --config ../../.prettierrc --check \"src/**/*.ts\""
+  }
+}

package/templates/README.md

@@ -0,0 +1,103 @@
+# Terse (self-hosted)
+
+You're running a self-hosted Terse instance. This directory holds everything needed to operate it:
+
+```
+docker-compose.yml   # service definitions (postgres, backend, frontend)
+.env                 # all configuration (URLs, ports, secrets) — edit here
+README.md            # you are here
+```
+
+## Daily operations
+
+| Goal                          | Command                              |
+| ----------------------------- | ------------------------------------ |
+| Open the UI                   | visit the `FRONTEND_URL` from `.env` |
+| Tail logs (all services)      | `docker compose logs -f`             |
+| Tail backend only             | `docker compose logs -f backend`     |
+| Restart after editing `.env`  | `docker compose up -d`               |
+| Stop everything               | `docker compose down`                |
+| Stop and delete all data      | `docker compose down -v`             |
+| Pull the latest image         | `docker compose pull && docker compose up -d` |
+| Open a shell in the backend   | `docker compose exec backend sh`     |
+| Check service status          | `docker compose ps`                  |
+
+## What's running
+
+- **postgres** — Postgres 16, data persisted in the `terse_postgres` Docker volume.
+- **backend** — Terse API, port from `BACKEND_URL` in `.env`. SQLite for local secrets lives in the `terse_sqlite` volume.
+- **frontend** — Vite dev server, port from `FRONTEND_URL` in `.env`.
+
+Both backend and frontend run from the same prebuilt image: `us-central1-docker.pkg.dev/fluid-analogy-473415-c2/public/terse:latest`. To pin to a specific tag, uncomment `TERSE_IMAGE=` at the bottom of `.env`.
+
+## Configuration
+
+Everything user-tunable lives in `.env`:
+
+- **URLs** — `FRONTEND_URL` / `BACKEND_URL` must match what your browser sees. If you put Terse behind a reverse proxy or a real domain, change both and restart.
+- **Postgres** — credentials and host port. Change before first start; changing later requires `docker compose down -v` (destroys data).
+- **Secrets** — `JWT_SECRET` and `LOCAL_SECRETS_ENCRYPTION_KEY` are generated for you. Rotating `LOCAL_SECRETS_ENCRYPTION_KEY` invalidates any stored integration credentials.
+
+After any edit, run `docker compose up -d` to apply.
+
+## Connecting integrations
+
+All integration config lives in this same `.env`. There's no second config file and no per-integration secrets store. After editing, `docker compose up -d` restarts the affected containers and the integration appears in the dashboard.
+
+- **API-key integrations** — Datadog, Snowflake, HeyReach, LaunchDarkly, PostHog. No env vars needed; paste the API key in the dashboard at connect time.
+- **OAuth integrations** — Gmail, GitHub, Slack, Linear, Notion, Attio. Gated by env vars. Every required `<PROVIDER>_CLIENT_ID` / `_CLIENT_SECRET` / `_REDIRECT_URI` (names vary slightly per provider) must be set, otherwise the integration is hidden.
+
+Callback URLs (`_REDIRECT_URI`, `_OAUTH_CALLBACK_URL`, etc.) must be reachable from the user's browser. For a default local install that's `http://localhost:3001/<provider>/callback`. If the OAuth provider rejects `localhost`, expose the backend via a tunnel (ngrok, Cloudflare Tunnel) and point the callback URL at the public hostname.
+
+The full env-var list per integration is in [docs.useterse.ai/self-hosting-control-plane](https://docs.useterse.ai/self-hosting-control-plane#integrations).
+
+## The `terse` CLI
+
+The installer also globally installs `terse-cli` (`npm i -g terse-cli`) and points it at this instance. From any directory:
+
+```
+terse target       # show which backend the CLI talks to
+terse init my-job  # scaffold a new job
+terse deploy       # deploy a job to your instance
+```
+
+CLI reference: [docs.useterse.ai/reference/cli](https://docs.useterse.ai/reference/cli).
+
+## Upgrading
+
+```
+docker compose pull
+docker compose up -d
+```
+
+The `latest` tag is updated on every push to `main` in the [TerseAI/Terse](https://github.com/TerseAI/Terse) repo. Pin `TERSE_IMAGE` in `.env` if you want explicit control over upgrades.
+
+## Backups
+
+The only stateful data lives in two Docker volumes:
+
+```
+docker volume ls | grep terse
+# terse_postgres   ← Postgres data
+# terse_sqlite     ← local secrets DB
+```
+
+Back them up with `docker run --rm -v terse_postgres:/data -v $PWD:/backup alpine tar czf /backup/postgres.tar.gz -C /data .` (and similarly for `terse_sqlite`).
+
+## Resources
+
+- **Docs** — [docs.useterse.ai](https://docs.useterse.ai)
+- **Quickstart** — [docs.useterse.ai/quickstart](https://docs.useterse.ai/quickstart)
+- **Self-hosting guide** — [docs.useterse.ai/self-hosting](https://docs.useterse.ai/self-hosting)
+- **SDK reference** — [docs.useterse.ai/reference/typescript-sdk](https://docs.useterse.ai/reference/typescript-sdk)
+- **Website** — [useterse.ai](https://useterse.ai)
+- **Source** — [github.com/TerseAI/Terse](https://github.com/TerseAI/Terse)
+
+## Getting help
+
+- **Bugs / feature requests** — open an issue at [github.com/TerseAI/Terse/issues](https://github.com/TerseAI/Terse/issues). Include `docker compose logs` output and the relevant section of `.env` (with secrets redacted).
+- **Questions** — check [docs.useterse.ai](https://docs.useterse.ai) first, then open a Discussion at [github.com/TerseAI/Terse/discussions](https://github.com/TerseAI/Terse/discussions).
+
+## Contributing
+
+Terse code is available on [Github](https://github.com/TerseAI/Terse). The contribution guide lives in the repo at [CONTRIBUTING.md](https://github.com/TerseAI/Terse/blob/main/CONTRIBUTING.md). PRs welcome for bug fixes, integrations, and docs improvements.

package/templates/docker-compose.yml

@@ -0,0 +1,59 @@
+services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: terse-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-postgres}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
+      POSTGRES_DB: ${POSTGRES_DB:-terse}
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"
+    volumes:
+      - terse_postgres:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-postgres}"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+  backend:
+    image: ${TERSE_IMAGE:-us-central1-docker.pkg.dev/fluid-analogy-473415-c2/public/terse:latest}
+    pull_policy: always
+    container_name: terse-backend
+    restart: unless-stopped
+    working_dir: /workspace/backend
+    depends_on:
+      postgres:
+        condition: service_healthy
+    env_file:
+      - ./.env
+    environment:
+      DATABASE_URL: postgres://${POSTGRES_USER:-postgres}:${POSTGRES_PASSWORD:-postgres}@postgres:5432/${POSTGRES_DB:-terse}
+      LOCAL_DB_URL: file:/data/local.db
+    ports:
+      - "${BACKEND_PORT:-3001}:3001"
+    volumes:
+      - terse_sqlite:/data
+    command: >
+      sh -c "pnpm exec prisma migrate deploy &&
+             pnpm exec prisma migrate deploy --schema=./prisma/local/schema.prisma &&
+             pnpm run dev:server"
+
+  frontend:
+    image: ${TERSE_IMAGE:-us-central1-docker.pkg.dev/fluid-analogy-473415-c2/public/terse:latest}
+    pull_policy: always
+    container_name: terse-frontend
+    restart: unless-stopped
+    working_dir: /workspace/frontend
+    depends_on:
+      - backend
+    env_file:
+      - ./.env
+    ports:
+      - "${FRONTEND_PORT:-5173}:5173"
+    command: pnpm exec vite --host 0.0.0.0 --port 5173
+
+volumes:
+  terse_postgres:
+  terse_sqlite: