write-helper 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marvin
+
+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,105 @@
+# WriteHelper (wh)
+
+A CLI tool to improve, translate, extend, and continue text using SAP AI Core.
+
+## Prerequisites
+
+- Node.js >= 20
+- Access to an SAP AI Core instance with an orchestration deployment
+
+## Install
+
+```bash
+git clone <repo-url> && cd WriteHelper
+npm install
+npm link
+```
+
+This makes the `wh` command available globally.
+
+## Uninstall
+
+```bash
+npm unlink -g write-helper
+rm -rf ~/.wh
+```
+
+## Configuration
+
+Before using the tool, configure your AI Core credentials. Pick one of the following:
+
+### Interactive setup
+
+```bash
+wh config
+```
+
+You will be prompted for:
+- AI Core Service URL
+- Client ID
+- Client Secret
+- Auth URL (token endpoint base)
+
+Credentials are saved to `~/.wh/config.json`.
+
+### Import from environment variable
+
+If you already have `AICORE_SERVICE_KEY` set (the full service key JSON):
+
+```bash
+wh config --env
+```
+
+### Environment variable only
+
+You can also skip `wh config` entirely and just export the variable:
+
+```bash
+export AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}'
+```
+
+## Usage
+
+```
+wh <command> [options] "your text"
+```
+
+### Commands
+
+| Command     | Description                                      |
+|-------------|--------------------------------------------------|
+| `improve`   | Fix grammar, spelling, and clarity (keeps tone)  |
+| `translate` | Translate text to a target language               |
+| `extend`    | Elaborate and expand text with more detail        |
+| `continue`  | Continue writing from where the text left off     |
+| `config`    | Configure AI Core credentials                    |
+
+### Options
+
+| Option              | Applies to  | Description                          | Default  |
+|---------------------|-------------|--------------------------------------|----------|
+| `-m, --model <name>`| all commands| Model to use                         | `gpt-4o` |
+| `-l, --lang <code>` | `translate` | Target language (e.g. `de`, `fr`)    | required |
+| `-e, --env`         | `config`    | Import credentials from env variable |          |
+
+### Examples
+
+```bash
+# Improve text
+wh improve "i think we should reconsider this descision"
+
+# Translate to German
+wh translate --lang=de "Hello, how are you?"
+
+# Extend a short message into a longer one
+wh extend "We should migrate to the new API"
+
+# Continue writing from an existing paragraph
+wh continue "Dear team, I wanted to follow up on our discussion from last week."
+
+# Use a different model
+wh improve --model=gpt-4o-mini "some text with erors"
+
+# Pipe output to clipboard (macOS)
+wh improve "some text" | pbcopy
+```

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "write-helper",
+  "version": "1.0.0",
+  "description": "CLI tool to improve, correct, and translate text using SAP AI Core",
+  "type": "module",
+  "license": "MIT",
+  "author": "schmarvinius",
+  "keywords": [
+    "cli",
+    "writing",
+    "text",
+    "improve",
+    "translate",
+    "ai",
+    "sap-ai-core"
+  ],
+  "files": [
+    "src"
+  ],
+  "bin": {
+    "wh": "./src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@sap-ai-sdk/orchestration": "^1",
+    "commander": "^13"
+  }
+}

package/src/index.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { createInterface } from 'node:readline/promises';
+
+const CONFIG_DIR = join(homedir(), '.wh');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+function loadConfig() {
+  if (!existsSync(CONFIG_FILE)) return null;
+  return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+}
+
+function saveConfig(config) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
+}
+
+function ensureCredentials() {
+  if (process.env.AICORE_SERVICE_KEY) return;
+  const config = loadConfig();
+  if (!config?.serviceKey) {
+    console.error('No AI Core credentials configured. Run "wh config" first or set AICORE_SERVICE_KEY env variable.');
+    process.exit(1);
+  }
+  process.env.AICORE_SERVICE_KEY = JSON.stringify(config.serviceKey);
+}
+
+async function importOrchestrationClient() {
+  ensureCredentials();
+  const { setLogLevel } = await import('@sap-cloud-sdk/util');
+  setLogLevel('warn', 'context');
+  const { OrchestrationClient } = await import('@sap-ai-sdk/orchestration');
+  return OrchestrationClient;
+}
+
+const IMPROVE_SYSTEM_PROMPT =
+  'You are a professional writing assistant. Your task is to improve, correct, and rewrite the given text.\n\n' +
+  'Rules:\n' +
+  '- Fix grammar, spelling, and punctuation errors\n' +
+  '- Improve clarity and readability\n' +
+  '- Do NOT change the tone or voice of the text. If it is casual, keep it casual. If it is formal, keep it formal. Do not make it more formal or casual than it already is\n' +
+  '- Never use em dashes. Use commas, semicolons, periods, or parentheses instead\n' +
+  '- Do not add new information or change the meaning\n' +
+  '- Output ONLY the improved text, nothing else. No explanations, no quotes, no prefixes';
+
+const EXTEND_SYSTEM_PROMPT =
+  'You are a professional writing assistant. Your task is to elaborate and expand on the given text, making it longer and more detailed.\n\n' +
+  'Rules:\n' +
+  '- Keep the same message, meaning, and intent\n' +
+  '- Match the original tone and voice exactly. Do NOT change the tone\n' +
+  '- Add more detail, examples, or supporting points where appropriate\n' +
+  '- Never use em dashes. Use commas, semicolons, periods, or parentheses instead\n' +
+  '- Output ONLY the expanded text, nothing else. No explanations, no quotes, no prefixes';
+
+const CONTINUE_SYSTEM_PROMPT =
+  'You are a professional writing assistant. Your task is to continue writing from where the given text left off.\n\n' +
+  'Rules:\n' +
+  '- Continue naturally from the end of the text\n' +
+  '- Match the original tone, voice, and style exactly. Do NOT change the tone\n' +
+  '- Stay on topic and maintain coherence with the original text\n' +
+  '- Never use em dashes. Use commas, semicolons, periods, or parentheses instead\n' +
+  '- Output ONLY the continuation (new text), nothing else. No explanations, no quotes, no prefixes';
+
+async function run(systemPrompt, userText, model) {
+  const OrchestrationClient = await importOrchestrationClient();
+  const client = new OrchestrationClient({
+    llm: {
+      model_name: model
+    }
+  });
+
+  const response = await client.chatCompletion({
+    messages: [
+      { role: 'system', content: systemPrompt },
+      { role: 'user', content: userText }
+    ]
+  });
+
+  return response.getContent();
+}
+
+const program = new Command();
+
+program
+  .name('wh')
+  .description('CLI tool to improve and translate text using SAP AI Core')
+  .version('1.0.0');
+
+program
+  .command('improve')
+  .description('Improve, correct, and rewrite text while preserving tone')
+  .argument('<text>', 'text to improve')
+  .option('-m, --model <name>', 'model to use', 'gpt-4o')
+  .action(async (text, opts) => {
+    try {
+      const result = await run(IMPROVE_SYSTEM_PROMPT, text, opts.model);
+      console.log(result);
+    } catch (err) {
+      console.error('Error:', err.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('translate')
+  .description('Translate text to a target language')
+  .argument('<text>', 'text to translate')
+  .requiredOption('-l, --lang <code>', 'target language (e.g. de, fr, es)')
+  .option('-m, --model <name>', 'model to use', 'gpt-4o')
+  .action(async (text, opts) => {
+    try {
+      const systemPrompt =
+        `You are a professional translator. Translate the given text to ${opts.lang}.\n\n` +
+        'Rules:\n' +
+        '- Produce a natural, fluent translation, not a word-for-word literal one\n' +
+        '- Preserve the original tone and register\n' +
+        '- Never use em dashes. Use commas, semicolons, periods, or parentheses instead\n' +
+        '- Output ONLY the translated text, nothing else. No explanations, no quotes, no prefixes';
+      const result = await run(systemPrompt, text, opts.model);
+      console.log(result);
+    } catch (err) {
+      console.error('Error:', err.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('extend')
+  .description('Elaborate and expand text to make it longer and more detailed')
+  .argument('<text>', 'text to extend')
+  .option('-m, --model <name>', 'model to use', 'gpt-4o')
+  .action(async (text, opts) => {
+    try {
+      const result = await run(EXTEND_SYSTEM_PROMPT, text, opts.model);
+      console.log(result);
+    } catch (err) {
+      console.error('Error:', err.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('continue')
+  .description('Continue writing from where the text left off')
+  .argument('<text>', 'text to continue from')
+  .option('-m, --model <name>', 'model to use', 'gpt-4o')
+  .action(async (text, opts) => {
+    try {
+      const result = await run(CONTINUE_SYSTEM_PROMPT, text, opts.model);
+      console.log(result);
+    } catch (err) {
+      console.error('Error:', err.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('config')
+  .description('Configure AI Core credentials')
+  .option('-e, --env', 'import credentials from AICORE_SERVICE_KEY env variable')
+  .action(async (opts) => {
+    try {
+      let serviceKey;
+      if (opts.env) {
+        if (!process.env.AICORE_SERVICE_KEY) {
+          console.error('AICORE_SERVICE_KEY environment variable is not set.');
+          process.exit(1);
+        }
+        serviceKey = JSON.parse(process.env.AICORE_SERVICE_KEY);
+        console.log('Imported credentials from AICORE_SERVICE_KEY.');
+      } else {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        const url = await rl.question('AI Core Service URL: ');
+        const clientid = await rl.question('Client ID: ');
+        const clientsecret = await rl.question('Client Secret: ');
+        const authUrl = await rl.question('Auth URL (token endpoint base): ');
+        rl.close();
+        serviceKey = {
+          serviceurls: { AI_API_URL: url },
+          clientid,
+          clientsecret,
+          url: authUrl
+        };
+      }
+      saveConfig({ serviceKey });
+      console.log(`Credentials saved to ${CONFIG_FILE}`);
+    } catch (err) {
+      console.error('Error:', err.message);
+      process.exit(1);
+    }
+  });
+
+program.parse();