Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
feat(desktop): launch parallel desktop instances from the packaged app (#2170)
Andrew Mikofalvyeafb72e2dc24
diff --git a/.changeset/desktop-instance-launcher.md b/.changeset/desktop-instance-launcher.mdnew file mode 100644index 000000000..85c154b72--- /dev/null+++ b/.changeset/desktop-instance-launcher.md@@ -0,0 +1,5 @@+---+"@inkeep/open-knowledge-desktop": patch+---++Add `bun run --filter=@inkeep/open-knowledge-desktop instances` to launch multiple isolated desktop instances in parallel from the packaged app. Each `<name>=<project>` gets its own `--user-data-dir` (own single-instance lock + storage), opens its project, and is launched detached via `open -n` so it survives the launching process — the path that works for agent/automated launches, where dev-mode windows don't. Launches are staggered to avoid a boot race. Script: `packages/desktop/scripts/launch-instances.mjs`.diff --git a/packages/desktop/package.json b/packages/desktop/package.jsonindex 67b9183b9..cad30ae9a 100644--- a/packages/desktop/package.json+++ b/packages/desktop/package.json@@ -20,6 +20,7 @@"postinstall": "node scripts/postinstall.mjs","rebuild:native": "electron-builder install-app-deps","smoke:mock-update": "OK_UPDATER_FORCE_DEV=1 node scripts/smoke-mock-update.mjs",+ "instances": "node scripts/launch-instances.mjs","typecheck": "tsc --noEmit","test": "bun --conditions=development test"},diff --git a/packages/desktop/scripts/launch-instances.mjs b/packages/desktop/scripts/launch-instances.mjsnew file mode 100644index 000000000..9ccd743ed--- /dev/null+++ b/packages/desktop/scripts/launch-instances.mjs@@ -0,0 +1,150 @@+#!/usr/bin/env node++import { execFileSync, spawn } from 'node:child_process';+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';+import { homedir } from 'node:os';+import { isAbsolute, join, resolve } from 'node:path';++if (process.platform !== 'darwin') {+ console.error(+ 'launch-instances: macOS only (uses `open`). The OpenKnowledge desktop is macOS-only.',+ );+ process.exit(1);+}++function parseArgs(argv) {+ const pairs = [];+ let appPath = process.env.OK_DESKTOP_APP ?? null;+ let userDataRoot = join(homedir(), '.ok', 'instances');+ for (let i = 0; i < argv.length; i++) {+ const arg = argv[i];+ if (arg === '--app') {+ appPath = argv[++i];+ } else if (arg === '--user-data-root') {+ userDataRoot = expandHome(argv[++i]);+ } else if (arg.includes('=')) {+ const idx = arg.indexOf('=');+ const name = arg.slice(0, idx);+ const project = arg.slice(idx + 1);+ if (!name || !project)+ throw new Error(`Bad instance spec "${arg}" (expected <name>=<projectPath>)`);+ pairs.push({ name, project: resolve(expandHome(project)) });+ } else {+ throw new Error(`Unrecognized argument "${arg}"`);+ }+ }+ return { pairs, appPath, userDataRoot };+}++function expandHome(p) {+ return p.startsWith('~') ? join(homedir(), p.slice(1)) : p;+}++function resolveAppPath(flagPath) {+ if (flagPath) {+ const abs = resolve(expandHome(flagPath));+ if (!existsSync(abs)) throw new Error(`--app path not found: ${abs}`);+ return abs;+ }+ const pkgRoot = resolve(import.meta.dirname, '..');+ const candidate = join(pkgRoot, 'dist-desktop', 'mac-arm64', 'OpenKnowledge.app');+ if (!existsSync(candidate)) {+ throw new Error(+ `No built app at ${candidate}.\n` ++ `Build it first: bun run build:dir (from packages/desktop)\n` ++ `or pass an explicit --app <path> / set OK_DESKTOP_APP.`,+ );+ }+ return candidate;+}++function ensureGitRepo(project) {+ if (!existsSync(project)) mkdirSync(project, { recursive: true });+ if (existsSync(join(project, '.git'))) return;+ execFileSync('git', ['-C', project, 'init', '-q']);+}++function emptyState() {+ return {+ recentProjects: [],+ lastOpenedProject: null,+ versionPendingInstall: null,+ attemptedInstall: null,+ lastSeenVersion: null,+ lastSuccessfulCheckAt: null,+ stuckHintShown: false,+ dismissedRepairForBundle: null,+ projectSessions: {},+ schemaVersion: 1,+ lastUsedProjectParent: null,+ pendingWindowRestore: null,+ spellCheckEnabled: true,+ };+}++function seedState(userDataDir, project, name) {+ mkdirSync(userDataDir, { recursive: true });+ const statePath = join(userDataDir, 'state.json');+ let state = emptyState();+ if (existsSync(statePath)) {+ try {+ state = { ...state, ...JSON.parse(readFileSync(statePath, 'utf-8')) };+ } catch {}+ }+ const now = new Date().toISOString();+ const recents = Array.isArray(state.recentProjects) ? state.recentProjects : [];+ const withoutThis = recents.filter((r) => r && r.path !== project);+ state.recentProjects = [{ path: project, name, lastOpenedAt: now }, ...withoutThis].slice(0, 20);+ state.lastOpenedProject = project;+ writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`);+ return statePath;+}++function launch(appPath, userDataDir) {+ const child = spawn('open', ['-n', appPath, '--args', `--user-data-dir=${userDataDir}`], {+ detached: true,+ stdio: 'ignore',+ });+ child.unref();+}++async function waitForServerLock(project, timeoutMs = 30000) {+ const lock = join(project, '.ok', 'local', 'server.lock');+ const deadline = Date.now() + timeoutMs;+ while (Date.now() < deadline) {+ if (existsSync(lock)) return true;+ await new Promise((r) => setTimeout(r, 500));+ }+ return false;+}++async function main() {+ const { pairs, appPath, userDataRoot } = parseArgs(process.argv.slice(2));+ if (pairs.length === 0) {+ console.error(+ 'Usage: node scripts/launch-instances.mjs <name>=<projectPath> [<name>=<projectPath> ...]',+ );+ process.exit(2);+ }+ const app = resolveAppPath(appPath);+ console.log(`app: ${app}`);+ for (const { name, project } of pairs) {+ const userDataDir = isAbsolute(userDataRoot)+ ? join(userDataRoot, name)+ : resolve(userDataRoot, name);+ ensureGitRepo(project);+ seedState(userDataDir, project, name);+ launch(app, userDataDir);+ process.stdout.write(`launched "${name}" -> ${project} (userData: ${userDataDir}) … `);+ const ready = await waitForServerLock(project);+ console.log(ready ? 'ready' : 'still booting (continuing)');+ }+ console.log(+ `\n${pairs.length} instance(s) launched. Each runs independently; quit a window to stop it.`,+ );+}++main().catch((err) => {+ console.error(`launch-instances: ${err.message}`);+ process.exit(1);+});