openwriter 0.6.0 → 0.6.1

package/dist/server/install-skill.js

@@ -1,19 +1,136 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import { execSync } from 'child_process';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+function log(msg) {
+    console.error(msg);
+}
+function isGloballyInstalled() {
+    try {
+        const result = execSync('openwriter --version', {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 10000,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function installGlobally() {
+    log('\n② Installing openwriter globally...');
+    // Try without sudo first (works on Windows, nvm, Homebrew, volta, etc.)
+    try {
+        execSync('npm install -g openwriter', { stdio: 'inherit', timeout: 120000 });
+        log('  ✓ Installed globally');
+        return true;
+    }
+    catch {
+        // Likely permission error on macOS/Linux system Node
+    }
+    // Try with sudo on non-Windows
+    if (process.platform !== 'win32') {
+        log('  Retrying with sudo...');
+        try {
+            execSync('sudo npm install -g openwriter', { stdio: 'inherit', timeout: 120000 });
+            log('  ✓ Installed globally (sudo)');
+            return true;
+        }
+        catch {
+            // sudo failed too
+        }
+    }
+    log('  ✗ Could not install globally. Run manually:');
+    log('    npm install -g openwriter');
+    return false;
+}
+function isMcpConfigured() {
+    const claudeJson = path.join(os.homedir(), '.claude.json');
+    if (!fs.existsSync(claudeJson))
+        return false;
+    try {
+        const content = JSON.parse(fs.readFileSync(claudeJson, 'utf-8'));
+        return !!content?.mcpServers?.openwriter;
+    }
+    catch {
+        return false;
+    }
+}
+function configureMcp() {
+    log('\n③ Configuring MCP server for Claude Code...');
+    // Try using claude CLI
+    try {
+        execSync('claude mcp add -s user openwriter -- openwriter --no-open', {
+            stdio: 'inherit',
+            timeout: 15000,
+        });
+        log('  ✓ MCP server configured');
+        return true;
+    }
+    catch {
+        // claude CLI not available or failed
+    }
+    // Fallback: edit ~/.claude.json directly
+    log('  claude CLI not found — writing config directly...');
+    const claudeJson = path.join(os.homedir(), '.claude.json');
+    try {
+        let config = {};
+        if (fs.existsSync(claudeJson)) {
+            config = JSON.parse(fs.readFileSync(claudeJson, 'utf-8'));
+        }
+        if (!config.mcpServers)
+            config.mcpServers = {};
+        // Add openwriter as first entry (Claude Code loads sequentially)
+        const existing = config.mcpServers;
+        config.mcpServers = {
+            openwriter: { command: 'openwriter', args: ['--no-open'] },
+            ...existing,
+        };
+        fs.writeFileSync(claudeJson, JSON.stringify(config, null, 2), 'utf-8');
+        log(`  ✓ MCP server added to ${claudeJson}`);
+        return true;
+    }
+    catch (err) {
+        log(`  ✗ Could not configure MCP server. Add manually:`);
+        log('    claude mcp add -s user openwriter -- openwriter --no-open');
+        return false;
+    }
+}
 export function installSkill() {
+    // Step 1: Copy SKILL.md
+    log('① Installing OpenWriter skill...');
     const source = path.join(__dirname, '../../skill/SKILL.md');
     const targetDir = path.join(os.homedir(), '.claude', 'skills', 'openwriter');
     const target = path.join(targetDir, 'SKILL.md');
     if (!fs.existsSync(source)) {
-        console.error(`Error: SKILL.md not found at ${source}`);
+        log(`  Error: SKILL.md not found at ${source}`);
         process.exit(1);
     }
     fs.mkdirSync(targetDir, { recursive: true });
     fs.copyFileSync(source, target);
-    console.error(`Installed OpenWriter skill to ${target}`);
+    log(`  ✓ Skill installed to ${target}`);
+    // Step 2: Global install (skip if already installed)
+    const alreadyInstalled = isGloballyInstalled();
+    if (alreadyInstalled) {
+        log('\n② openwriter already installed globally — skipping');
+    }
+    else {
+        if (!installGlobally()) {
+            process.exit(1);
+        }
+    }
+    // Step 3: Configure MCP server (skip if already configured)
+    if (isMcpConfigured()) {
+        log('\n③ MCP server already configured — skipping');
+    }
+    else {
+        configureMcp();
+    }
+    // Done
+    log('\n✓ OpenWriter is ready!');
+    log('  Restart Claude Code, then type /openwriter to start writing.\n');
     process.exit(0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openwriter",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "The open-source writing surface for AI agents. Markdown-native editor with pending change review — your agent writes, you accept or reject.",
   "type": "module",
   "license": "MIT",

package/skill/SKILL.md

@@ -36,30 +36,31 @@ Check whether the `openwriter` MCP tools are available (e.g. `read_pad`, `write_
 
 ### MCP tools ARE available (ready to use)
 
-The user already has OpenWriter configured — either they ran `npx openwriter install-skill` (which installed this skill) and added the MCP server, or they set it up manually. You're good to go.
+The user already has OpenWriter configured. You're good to go.
 
 **First action:** Share the browser URL:
 > OpenWriter is at **http://localhost:5050** — open it in your browser to see and review changes.
 
 Skip to [Writing Strategy](#writing-strategy) below.
 
-### MCP tools are NOT available (skill-first install)
+### MCP tools are NOT available (needs setup)
 
-The user installed this skill from a directory but hasn't set up the MCP server yet. OpenWriter needs an MCP server to provide the 31 editing tools.
+The user has this skill but hasn't set up the MCP server yet. One command does everything:
 
-**Step 1:** Tell the user to install globally and add the MCP server:
+```bash
+npx openwriter install-skill
+```
+
+This installs openwriter globally, configures the MCP server for Claude Code, and copies this skill — all in one step. After it finishes, the user just needs to restart their Claude Code session.
+
+**Fallback (if the command above fails):** Do it manually:
 
 ```bash
-# Install globally for instant startup (no npx resolution delay)
 npm install -g openwriter
-
-# Add the OpenWriter MCP server to Claude Code
 claude mcp add -s user openwriter -- openwriter --no-open
 ```
 
-Then restart the Claude Code session. The 57 MCP tools become available on next launch.
-
-**Step 2 (if the user can't run the command above):** Edit `~/.claude.json` directly. Add `openwriter` as the **first entry** in the `mcpServers` object — MCP servers load sequentially, so first in config = first to load:
+If `claude mcp add` can't run (e.g. nested session error), edit `~/.claude.json` directly. Add `openwriter` as the **first entry** in `mcpServers`:
 
 ```json
 {
@@ -72,14 +73,10 @@ Then restart the Claude Code session. The 57 MCP tools become available on next
 }
 ```
 
-**Why first?** Claude Code loads MCP servers sequentially in config order. If `openwriter` is last, it waits for every other server to finish connecting first. Putting it first makes it available instantly.
-
-After editing, tell the user:
+After setup, tell the user:
 1. Restart your Claude Code session (MCP servers load on startup)
 2. Open http://localhost:5050 in your browser
 
-**Note:** You cannot run `claude mcp add` from inside a session (nested session error). That's why we edit the JSON directly when configuring from within Claude Code. Also, `claude mcp add` appends to the end — always verify the entry is first after adding.
-
 ## Document Identity: Titles vs DocIds
 
 Every document has an immutable **docId** (8-char hex, e.g. `a1b2c3d4`) in its YAML frontmatter. Titles are for human communication and agent reasoning. DocIds are for agent action.