summon-ws 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 juan294
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,145 @@
+# summon — Native Ghostty workspace launcher
+
+![Chapa Badge](https://chapa.thecreativetoken.com/u/juan294/badge.svg)
+[![CI](https://github.com/juan294/summon/actions/workflows/ci.yml/badge.svg)](https://github.com/juan294/summon/actions/workflows/ci.yml)
+[![CodeQL](https://github.com/juan294/summon/actions/workflows/codeql.yml/badge.svg)](https://github.com/juan294/summon/actions/workflows/codeql.yml)
+[![npm version](https://img.shields.io/npm/v/summon-ws)](https://www.npmjs.com/package/summon-ws)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org)
+[![license](https://img.shields.io/npm/l/summon-ws)](./LICENSE)
+
+Summon your Ghostty workspace with one command. Native splits, no tmux.
+
+---
+
+## Install
+
+```bash
+npm i -g summon-ws
+```
+
+Requires Node >= 18, macOS, and [Ghostty](https://ghostty.org) 1.3.0+.
+
+## Quick Start
+
+```bash
+summon .                          # launch workspace in current directory
+summon add myapp ~/code/myapp     # register a project
+summon myapp                      # launch by project name
+```
+
+## How It Works
+
+Summon generates and executes AppleScript that drives Ghostty's native split system. No terminal multiplexer -- just native Ghostty panes with commands running in each one.
+
+## Default Layout
+
+```
+summon .    (panes=2, editor=claude, sidebar=lazygit, server=true)
+
++-------------------- 75% ---------------------+------ 25% ------+
+|                    |                          |                 |
+|                    |    claude (2)            |                 |
+|    claude (1)      |                          |    lazygit      |
+|                    +--------------------------+                 |
+|                    |                          |                 |
+|                    |    server (shell)        |                 |
+|                    |                          |                 |
++--------------------+--------------------------+-----------------+
+      left col             right col                sidebar
+```
+
+## Layout Presets
+
+| Preset | Panes | Server | Use case |
+|---|---|---|---|
+| `full` | 3 | yes | Multi-agent coding + dev server |
+| `pair` | 2 | yes | Two editors + dev server |
+| `minimal` | 1 | no | Simple editor + sidebar only |
+| `cli` | 1 | yes | CLI tool development -- editor + server |
+| `mtop` | 2 | yes | System monitoring -- editor + mtop + server |
+
+```bash
+summon . --layout minimal         # 1 editor pane, no server
+summon . -l pair                  # 2 editors + server
+```
+
+## Per-project Config
+
+Drop a `.summon` file in your project root to override machine-level config:
+
+```ini
+# .summon
+layout=minimal
+editor=vim
+server=npm run dev
+```
+
+Config resolution order: **CLI flags > .summon > machine config > preset > defaults**
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `summon <target>` | Launch workspace (project name, path, or `.`) |
+| `summon add <name> <path>` | Register a project name to a directory |
+| `summon remove <name>` | Remove a registered project |
+| `summon list` | List all registered projects |
+| `summon set <key> [value]` | Set a machine-level config value |
+| `summon config` | Show current machine configuration |
+
+## CLI Flags
+
+| Flag | Description |
+|---|---|
+| `-l, --layout <preset>` | Use a layout preset (`minimal`, `full`, `pair`, `cli`, `mtop`) |
+| `--editor <cmd>` | Override editor command |
+| `--panes <n>` | Override number of editor panes |
+| `--editor-size <n>` | Override editor width percentage |
+| `--sidebar <cmd>` | Override sidebar command |
+| `--server <value>` | Server pane: `true`, `false`, or a command |
+| `-n, --dry-run` | Print generated AppleScript without executing |
+| `-h, --help` | Show help message |
+| `-v, --version` | Show version number |
+
+## Config Keys
+
+| Key | Default | Description |
+|---|---|---|
+| `editor` | `claude` | Command launched in editor panes |
+| `sidebar` | `lazygit` | Command launched in the sidebar pane |
+| `panes` | `2` | Number of editor panes |
+| `editor-size` | `75` | Width percentage for the editor grid |
+| `server` | `true` | Server pane: `true` (shell), `false` (none), or a command |
+| `layout` | | Default layout preset |
+
+Machine config is stored at `~/.config/summon/config`:
+
+```bash
+summon set editor vim               # use vim as the editor
+summon set server "npm run dev"     # run dev server automatically
+summon set layout minimal           # default to minimal preset
+```
+
+## Docs
+
+- [Architecture](docs/architecture.md) -- module map, AppleScript generation, layout algorithm
+- [User Manual](docs/user-manual.md) -- full command reference, walkthrough, troubleshooting
+- [Changelog](CHANGELOG.md) -- release history
+- [Publishing](docs/publishing.md) -- npm publish checklist
+
+## Contributing
+
+Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md) for details on the development workflow, commit conventions, and PR guidelines.
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.
+
+## Security
+
+To report a vulnerability, please follow the [Security Policy](SECURITY.md). Do not open a public issue.
+
+## License
+
+[MIT](./LICENSE)

package/dist/index.js

@@ -0,0 +1,577 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { parseArgs } from "util";
+import { resolve } from "path";
+
+// src/config.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var CONFIG_DIR = join(homedir(), ".config", "summon");
+var PROJECTS_FILE = join(CONFIG_DIR, "projects");
+var CONFIG_FILE = join(CONFIG_DIR, "config");
+function ensureConfig() {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  if (!existsSync(PROJECTS_FILE)) writeFileSync(PROJECTS_FILE, "");
+  if (!existsSync(CONFIG_FILE)) writeFileSync(CONFIG_FILE, "editor=claude\n");
+}
+function readKVFile(path) {
+  const map = /* @__PURE__ */ new Map();
+  if (!existsSync(path)) return map;
+  const content = readFileSync(path, "utf-8").trim();
+  if (!content) return map;
+  for (const line of content.split("\n")) {
+    const idx = line.indexOf("=");
+    if (idx === -1) continue;
+    map.set(line.slice(0, idx), line.slice(idx + 1));
+  }
+  return map;
+}
+function readKV(file) {
+  ensureConfig();
+  return readKVFile(file);
+}
+function writeKV(file, map) {
+  const lines = [...map.entries()].map(([k, v]) => `${k}=${v}`);
+  writeFileSync(file, lines.join("\n") + "\n");
+}
+function addProject(name, path) {
+  const projects = readKV(PROJECTS_FILE);
+  projects.set(name, path);
+  writeKV(PROJECTS_FILE, projects);
+}
+function removeProject(name) {
+  const projects = readKV(PROJECTS_FILE);
+  const existed = projects.delete(name);
+  writeKV(PROJECTS_FILE, projects);
+  return existed;
+}
+function getProject(name) {
+  return readKV(PROJECTS_FILE).get(name);
+}
+function listProjects() {
+  return readKV(PROJECTS_FILE);
+}
+function setConfig(key, value) {
+  const config = readKV(CONFIG_FILE);
+  config.set(key, value);
+  writeKV(CONFIG_FILE, config);
+}
+function getConfig(key) {
+  return readKV(CONFIG_FILE).get(key);
+}
+function listConfig() {
+  return readKV(CONFIG_FILE);
+}
+
+// src/launcher.ts
+import { existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
+import { createInterface } from "readline";
+import { execSync, execFileSync } from "child_process";
+
+// src/layout.ts
+var DEFAULT_OPTIONS = {
+  editor: "claude",
+  editorPanes: 2,
+  editorSize: 75,
+  sidebarCommand: "lazygit",
+  server: "true",
+  secondaryEditor: ""
+};
+function parseServer(value) {
+  if (value === "false" || value === "") {
+    return { hasServer: false, serverCommand: null };
+  }
+  if (value === "true") {
+    return { hasServer: true, serverCommand: null };
+  }
+  return { hasServer: true, serverCommand: value };
+}
+var PRESETS = {
+  minimal: { editorPanes: 1, server: "false" },
+  full: { editorPanes: 3, server: "true" },
+  pair: { editorPanes: 2, server: "true" },
+  cli: { editorPanes: 1, server: "true" },
+  mtop: { editorPanes: 2, server: "true", secondaryEditor: "mtop" }
+};
+function isPresetName(value) {
+  return value in PRESETS;
+}
+function getPreset(name) {
+  return PRESETS[name];
+}
+function planLayout(partial) {
+  const opts = { ...DEFAULT_OPTIONS, ...partial };
+  const leftColumnCount = Math.ceil(opts.editorPanes / 2);
+  const { hasServer, serverCommand } = parseServer(opts.server);
+  return {
+    editorSize: opts.editorSize,
+    sidebarSize: 100 - opts.editorSize,
+    leftColumnCount,
+    rightColumnEditorCount: opts.editorPanes - leftColumnCount,
+    editor: opts.editor,
+    sidebarCommand: opts.sidebarCommand,
+    hasServer,
+    serverCommand,
+    secondaryEditor: opts.secondaryEditor || null
+  };
+}
+
+// src/script.ts
+function escapeAppleScript(s) {
+  return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r");
+}
+function generateAppleScript(plan, targetDir) {
+  const lines = [];
+  const add = (indent, line) => {
+    lines.push("    ".repeat(indent) + line);
+  };
+  const blank = () => lines.push("");
+  const sendCommand = (pane, cmd) => {
+    add(1, `input text "${escapeAppleScript(cmd)}" to ${pane}`);
+    add(1, `send key "enter" to ${pane}`);
+  };
+  const setConfigCommand = (cmd) => {
+    add(1, `set command of cfg to "${escapeAppleScript(cmd)}"`);
+  };
+  const clearConfigCommand = () => {
+    add(1, `set command of cfg to ""`);
+  };
+  add(0, 'tell application "Ghostty"');
+  add(1, "activate");
+  blank();
+  add(1, "set cfg to new surface configuration");
+  add(1, `set initial working directory of cfg to "${escapeAppleScript(targetDir)}"`);
+  blank();
+  add(1, "set win to front window");
+  add(1, "set paneRoot to terminal 1 of selected tab of win");
+  blank();
+  const editorCmd = plan.editor;
+  const secondaryCmd = plan.secondaryEditor ?? editorCmd;
+  if (plan.sidebarCommand) {
+    setConfigCommand(plan.sidebarCommand);
+  }
+  add(1, "set paneSidebar to split paneRoot direction right with configuration cfg");
+  const needsRightColumn = plan.rightColumnEditorCount > 0 || plan.hasServer;
+  if (needsRightColumn) {
+    blank();
+    if (plan.rightColumnEditorCount > 0) {
+      if (secondaryCmd) {
+        setConfigCommand(secondaryCmd);
+      } else {
+        clearConfigCommand();
+      }
+      add(1, "set paneRightCol to split paneRoot direction right with configuration cfg");
+    } else {
+      if (plan.serverCommand) {
+        setConfigCommand(plan.serverCommand);
+      } else {
+        clearConfigCommand();
+      }
+      add(1, "set paneRightCol to split paneRoot direction right with configuration cfg");
+    }
+  }
+  let lastLeftPane = "paneRoot";
+  if (plan.leftColumnCount > 1 && editorCmd) {
+    setConfigCommand(editorCmd);
+  }
+  for (let i = 2; i <= plan.leftColumnCount; i++) {
+    const name = `paneLeft${i}`;
+    blank();
+    add(1, `set ${name} to split ${lastLeftPane} direction down with configuration cfg`);
+    lastLeftPane = name;
+  }
+  if (needsRightColumn && plan.rightColumnEditorCount > 0) {
+    let lastRightPane = "paneRightCol";
+    let nextRight = 2;
+    if (plan.rightColumnEditorCount > 1 && secondaryCmd) {
+      setConfigCommand(secondaryCmd);
+    }
+    for (let i = 2; i <= plan.rightColumnEditorCount; i++) {
+      const name = `paneRight${nextRight}`;
+      blank();
+      add(1, `set ${name} to split ${lastRightPane} direction down with configuration cfg`);
+      lastRightPane = name;
+      nextRight++;
+    }
+    if (plan.hasServer) {
+      const name = `paneRight${nextRight}`;
+      blank();
+      if (plan.serverCommand) {
+        setConfigCommand(plan.serverCommand);
+      } else {
+        clearConfigCommand();
+      }
+      add(1, `set ${name} to split ${lastRightPane} direction down with configuration cfg`);
+    }
+  }
+  blank();
+  if (editorCmd) {
+    sendCommand("paneRoot", editorCmd);
+  }
+  blank();
+  add(1, "focus paneRoot");
+  add(0, "end tell");
+  return lines.join("\n");
+}
+
+// src/launcher.ts
+var SAFE_COMMAND_RE = /^[a-zA-Z0-9_][a-zA-Z0-9_.+-]*$/;
+function ensureGhostty() {
+  if (!existsSync2("/Applications/Ghostty.app")) {
+    console.error(
+      "Ghostty.app not found. Please install Ghostty 1.3.0+ from https://ghostty.org"
+    );
+    process.exit(1);
+  }
+}
+function executeScript(script) {
+  execSync("osascript", { input: script, encoding: "utf-8" });
+}
+function resolveCommand(cmd) {
+  if (!SAFE_COMMAND_RE.test(cmd)) {
+    console.error(`Invalid command name: "${cmd}". Command names may only contain letters, digits, hyphens, dots, underscores, and plus signs.`);
+    process.exit(1);
+  }
+  try {
+    return execSync(`command -v ${cmd}`, { encoding: "utf-8" }).trim();
+  } catch {
+    return null;
+  }
+}
+function resolveFullPath(cmdString) {
+  const parts = cmdString.split(" ");
+  const bin = parts[0];
+  const fullPath = resolveCommand(bin);
+  if (!fullPath) return cmdString;
+  parts[0] = fullPath;
+  return parts.join(" ");
+}
+function prompt(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve2(answer.trim().toLowerCase());
+    });
+  });
+}
+var KNOWN_INSTALL_COMMANDS = {
+  claude: () => ["npm", ["install", "-g", "@anthropic-ai/claude-code"]],
+  lazygit: () => {
+    try {
+      execSync("command -v brew", { stdio: "ignore" });
+      return ["brew", ["install", "lazygit"]];
+    } catch {
+      return null;
+    }
+  }
+};
+async function ensureCommand(cmd) {
+  if (resolveCommand(cmd)) return;
+  const getInstall = KNOWN_INSTALL_COMMANDS[cmd];
+  const installCmd = getInstall ? getInstall() : null;
+  if (!installCmd) {
+    console.error(
+      `\`${cmd}\` is required but not installed, and no known install method was found.`
+    );
+    console.error(
+      `Please install \`${cmd}\` manually or change your config with: summon set editor <command>`
+    );
+    process.exit(1);
+  }
+  const [installBin, installArgs] = installCmd;
+  const installDisplay = [installBin, ...installArgs].join(" ");
+  console.log(`\`${cmd}\` is required but not installed on this machine.`);
+  const answer = await prompt(`Install it now with \`${installDisplay}\`? [Y/n] `);
+  if (answer && answer !== "y" && answer !== "yes") {
+    console.log(`\`${cmd}\` is required for this workspace layout. Exiting.`);
+    process.exit(1);
+  }
+  console.log(`Running: ${installDisplay}`);
+  try {
+    execFileSync(installBin, installArgs, { stdio: "inherit" });
+  } catch {
+    console.error(
+      `Failed to install \`${cmd}\`. Please install it manually and try again.`
+    );
+    process.exit(1);
+  }
+  if (!resolveCommand(cmd)) {
+    console.error(`\`${cmd}\` still not found after install. Please check your PATH.`);
+    process.exit(1);
+  }
+  console.log(`\`${cmd}\` installed successfully!
+`);
+}
+function resolveConfig(targetDir, cliOverrides) {
+  const project = readKVFile(join2(targetDir, ".summon"));
+  const layoutKey = cliOverrides.layout ?? project.get("layout") ?? getConfig("layout");
+  let base = {};
+  if (layoutKey) {
+    if (isPresetName(layoutKey)) {
+      base = getPreset(layoutKey);
+    } else {
+      console.warn(
+        `Unknown layout preset: "${layoutKey}". Valid presets: minimal, full, pair, cli, mtop. Using defaults.`
+      );
+    }
+  }
+  const pick = (cli, projKey) => cli ?? project.get(projKey) ?? getConfig(projKey);
+  const editor = pick(cliOverrides.editor, "editor");
+  const sidebar = pick(cliOverrides.sidebar, "sidebar");
+  const panes = pick(cliOverrides.panes, "panes");
+  const editorSize = pick(cliOverrides["editor-size"], "editor-size");
+  const server = pick(cliOverrides.server, "server");
+  const result = { ...base };
+  if (editor !== void 0) result.editor = editor;
+  if (sidebar !== void 0) result.sidebarCommand = sidebar;
+  if (panes !== void 0) {
+    const parsed = parseInt(panes, 10);
+    if (Number.isNaN(parsed) || parsed < 1) {
+      console.warn(
+        `Invalid panes value: "${panes}". Must be a positive integer. Using default (2).`
+      );
+      result.editorPanes = 2;
+    } else {
+      result.editorPanes = parsed;
+    }
+  }
+  if (editorSize !== void 0) {
+    const parsed = parseInt(editorSize, 10);
+    if (Number.isNaN(parsed) || parsed < 1 || parsed > 99) {
+      console.warn(
+        `Invalid editor-size value: "${editorSize}". Must be 1-99. Using default (75).`
+      );
+      result.editorSize = 75;
+    } else {
+      result.editorSize = parsed;
+    }
+  }
+  if (server !== void 0) result.server = server;
+  return { opts: result };
+}
+async function launch(targetDir, cliOverrides) {
+  if (!existsSync2(targetDir)) {
+    console.error(`Directory not found: ${targetDir}`);
+    process.exit(1);
+  }
+  ensureGhostty();
+  const { opts } = resolveConfig(targetDir, cliOverrides ?? {});
+  const plan = planLayout(opts);
+  if (plan.editor) await ensureCommand(plan.editor);
+  if (plan.sidebarCommand) await ensureCommand(plan.sidebarCommand);
+  if (plan.secondaryEditor) {
+    const secondaryBin = plan.secondaryEditor.split(" ")[0];
+    await ensureCommand(secondaryBin);
+  }
+  if (plan.serverCommand) {
+    const serverBin = plan.serverCommand.split(" ")[0];
+    await ensureCommand(serverBin);
+  }
+  if (plan.editor) plan.editor = resolveFullPath(plan.editor);
+  if (plan.sidebarCommand) plan.sidebarCommand = resolveFullPath(plan.sidebarCommand);
+  if (plan.secondaryEditor) plan.secondaryEditor = resolveFullPath(plan.secondaryEditor);
+  if (plan.serverCommand) plan.serverCommand = resolveFullPath(plan.serverCommand);
+  const script = generateAppleScript(plan, targetDir);
+  if (cliOverrides?.dryRun) {
+    console.log(script);
+    return;
+  }
+  executeScript(script);
+}
+
+// src/index.ts
+var HELP = `
+summon -- Launch multi-pane Ghostty workspaces
+
+Usage:
+  summon <target>             Launch workspace (project name, path, or '.')
+  summon add <name> <path>    Register a project name -> path mapping
+  summon remove <name>        Remove a registered project
+  summon list                 List all registered projects
+  summon set <key> [value]    Set a machine-level config value
+  summon config               Show current machine configuration
+
+Options:
+  -h, --help                  Show this help message
+  -v, --version               Show version number
+  -l, --layout <preset>       Use a layout preset (minimal, full, pair, cli, mtop)
+  --editor <cmd>              Override editor command
+  --panes <n>                 Override number of editor panes
+  --editor-size <n>           Override editor width %
+  --sidebar <cmd>             Override sidebar command
+  --server <value>            Server pane: true, false, or a command
+  -n, --dry-run               Print generated AppleScript without executing
+
+Config keys:
+  editor        Command for coding panes (default: claude)
+  sidebar       Command for sidebar pane (default: lazygit)
+  panes         Number of editor panes (default: 2)
+  editor-size   Width % for editor grid (default: 75)
+  server        Server pane toggle (default: true)
+  layout        Default layout preset
+
+Layout presets:
+  minimal       1 editor pane, no server
+  full          3 editor panes + server
+  pair          2 editor panes + server
+  cli           1 editor pane + server
+  mtop          editor + mtop + server + lazygit sidebar
+
+Per-project config:
+  Place a .summon file in your project root with key=value pairs.
+  Project config overrides machine config; CLI flags override both.
+
+Requires: macOS, Ghostty 1.3.0+
+
+Examples:
+  summon .                        Launch workspace in current directory
+  summon myapp                    Launch workspace for registered project
+  summon add myapp ~/code/app     Register a project
+  summon set editor claude        Set the editor command
+  summon . --layout minimal       Launch with minimal preset
+  summon . --server "npm run dev" Launch with custom server command
+`.trim();
+function showHelp() {
+  console.log(HELP);
+}
+function expandHome(p) {
+  return resolve(p.replace(/^~/, process.env.HOME ?? ""));
+}
+var parseOpts = {
+  allowPositionals: true,
+  options: {
+    help: { type: "boolean", short: "h" },
+    version: { type: "boolean", short: "v" },
+    layout: { type: "string", short: "l" },
+    editor: { type: "string" },
+    panes: { type: "string" },
+    "editor-size": { type: "string" },
+    sidebar: { type: "string" },
+    server: { type: "string" },
+    "dry-run": { type: "boolean", short: "n" }
+  }
+};
+function safeParse() {
+  try {
+    return parseArgs(parseOpts);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`Error: ${msg}`);
+    console.error(`Run 'summon --help' for usage information.`);
+    process.exit(1);
+  }
+}
+var { values, positionals } = safeParse();
+if (values.version) {
+  console.log("0.1.0");
+  process.exit(0);
+}
+if (values.help) {
+  showHelp();
+  process.exit(0);
+}
+var [subcommand, ...args] = positionals;
+if (!subcommand) {
+  console.error(HELP);
+  process.exit(1);
+}
+switch (subcommand) {
+  case "add": {
+    const [name, path] = args;
+    if (!name || !path) {
+      console.error("Usage: summon add <name> <path>");
+      process.exit(1);
+    }
+    const resolved = expandHome(path);
+    addProject(name, resolved);
+    console.log(`Registered: ${name} \u2192 ${resolved}`);
+    break;
+  }
+  case "remove": {
+    const [name] = args;
+    if (!name) {
+      console.error("Usage: summon remove <name>");
+      process.exit(1);
+    }
+    const existed = removeProject(name);
+    if (existed) {
+      console.log(`Removed: ${name}`);
+    } else {
+      console.error(`Project not found: ${name}`);
+      console.error("Run 'summon list' to see registered projects.");
+      process.exit(1);
+    }
+    break;
+  }
+  case "list": {
+    const projects = listProjects();
+    if (projects.size === 0) {
+      console.log("No projects registered. Use: summon add <name> <path>");
+    } else {
+      console.log("Registered projects:");
+      for (const [name, path] of projects) {
+        console.log(`  ${name} \u2192 ${path}`);
+      }
+    }
+    break;
+  }
+  case "set": {
+    const [key, value] = args;
+    if (!key) {
+      console.error("Usage: summon set <key> [value]");
+      process.exit(1);
+    }
+    const VALID_KEYS = ["editor", "sidebar", "panes", "editor-size", "server", "layout"];
+    if (!VALID_KEYS.includes(key)) {
+      console.warn(`Warning: unknown config key "${key}". Valid keys: ${VALID_KEYS.join(", ")}`);
+    }
+    setConfig(key, value ?? "");
+    if (value) {
+      console.log(`Set ${key} \u2192 ${value}`);
+    } else {
+      console.log(`Set ${key} \u2192 (empty, will open plain shell)`);
+    }
+    break;
+  }
+  case "config": {
+    const config = listConfig();
+    console.log("Machine config:");
+    for (const [key, value] of config) {
+      console.log(`  ${key} \u2192 ${value || "(plain shell)"}`);
+    }
+    break;
+  }
+  default: {
+    const target = subcommand;
+    let targetDir;
+    if (target === ".") {
+      targetDir = process.cwd();
+    } else if (target.startsWith("/") || target.startsWith("~")) {
+      targetDir = expandHome(target);
+    } else {
+      const path = getProject(target);
+      if (!path) {
+        console.error(`Unknown project: ${target}`);
+        console.error(
+          `Register it with: summon add ${target} /path/to/project`
+        );
+        console.error(`Or see available:  summon list`);
+        process.exit(1);
+      }
+      targetDir = path;
+    }
+    const overrides = {};
+    if (values.layout) overrides.layout = values.layout;
+    if (values.editor) overrides.editor = values.editor;
+    if (values.panes) overrides.panes = values.panes;
+    if (values["editor-size"]) overrides["editor-size"] = values["editor-size"];
+    if (values.sidebar) overrides.sidebar = values.sidebar;
+    if (values.server) overrides.server = values.server;
+    if (values["dry-run"]) overrides.dryRun = true;
+    await launch(targetDir, overrides);
+  }
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "summon-ws",
+  "version": "0.1.0",
+  "description": "Launch configurable multi-pane Ghostty workspaces with one command",
+  "type": "module",
+  "packageManager": "pnpm@10.29.2",
+  "bin": {
+    "summon": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "pnpm run build",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "ghostty",
+    "terminal",
+    "workspace",
+    "splits",
+    "applescript",
+    "developer-tools",
+    "cli",
+    "macos"
+  ],
+  "author": "juan294",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/juan294/summon.git"
+  },
+  "homepage": "https://github.com/juan294/summon#readme",
+  "bugs": {
+    "url": "https://github.com/juan294/summon/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.2.3",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^10.0.2",
+    "husky": "^9.1.7",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.56.1",
+    "vitest": "^4.0.18"
+  }
+}