@camelai/tldr 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QAML AI
+
+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,111 @@
+# tldr
+
+A tiny CLI that summarizes text using OpenAI, Anthropic, or OpenRouter.
+
+## Install
+
+### Run locally
+
+```bash
+npm install
+node ./bin/tldr.js --help
+```
+
+### Install globally from npm
+
+```bash
+npm install -g @camelai/tldr
+```
+
+### Install from this repo
+
+```bash
+npm install -g github:qaml-ai/tldr
+```
+
+## Usage
+
+Summarize a prompt:
+
+```bash
+tldr "Summarize the key points from this meeting note..."
+```
+
+Summarize stdin:
+
+```bash
+cat notes.txt | tldr
+```
+
+Choose a provider explicitly:
+
+```bash
+tldr --provider openai "text"
+tldr --provider anthropic "text"
+tldr --provider openrouter "text"
+```
+
+Override the model:
+
+```bash
+tldr --provider openai --model gpt-5.4-nano "text"
+tldr --provider anthropic --model claude-4-haiku-20250305 "text"
+tldr --provider openrouter --model google/gemini-3.1-flash-lite-preview "text"
+```
+
+Override the system prompt:
+
+```bash
+tldr --system "Summarize in 3 bullet points." "text"
+```
+
+## Options
+
+- `-p, --provider <name>`: `openai`, `anthropic`, or `openrouter`
+- `-m, --model <model>`: override the model
+- `-s, --system <prompt>`: override the summarization system prompt
+- `-h, --help`: show help
+
+## Environment variables
+
+API keys:
+
+- `OPENAI_API_KEY`
+- `ANTHROPIC_API_KEY`
+- `OPENROUTER_API_KEY`
+
+Defaults:
+
+- `TLDR_SYSTEM_PROMPT`
+- `TLDR_OPENAI_MODEL` default: `gpt-5.4-nano`
+- `TLDR_ANTHROPIC_MODEL` default: `claude-4-haiku-20250305`
+- `TLDR_OPENROUTER_MODEL` default: `google/gemini-3.1-flash-lite-preview`
+
+Legacy env vars are also supported:
+
+- `SUMMARIZE_SYSTEM_PROMPT`
+- `SUMMARIZE_OPENAI_MODEL`
+- `SUMMARIZE_ANTHROPIC_MODEL`
+- `SUMMARIZE_OPENROUTER_MODEL`
+
+## Default model selection
+
+If `--provider` is omitted, `tldr` picks the first available provider in this order:
+
+1. `OPENAI_API_KEY`
+2. `ANTHROPIC_API_KEY`
+3. `OPENROUTER_API_KEY`
+
+## Publish to npm
+
+When you're ready:
+
+```bash
+npm publish
+```
+
+Because `publishConfig.access` is set to `public`, this package is ready for public npm publishing.
+
+## License
+
+MIT

package/bin/tldr.js

@@ -0,0 +1,239 @@
+#!/usr/bin/env node
+
+import process from 'node:process';
+
+const DEFAULT_SYSTEM_PROMPT = process.env.TLDR_SYSTEM_PROMPT || process.env.SUMMARIZE_SYSTEM_PROMPT || [
+  'You are a concise, accurate summarization assistant.',
+  'Summarize the user input clearly and faithfully.',
+  'Preserve the key facts, decisions, dates, numbers, and action items.',
+  'Use short paragraphs or bullet points when that improves clarity.',
+  'Do not invent details.'
+].join(' ');
+
+function printHelp() {
+  console.log(`tldr - summarize text from stdin or a prompt\n\nUsage:\n  tldr [options] [prompt...]\n  echo "long text" | tldr [options]\n\nOptions:\n  -p, --provider <name>   Provider: openai | anthropic | openrouter\n  -s, --system <prompt>   Override the system prompt\n  -m, --model <model>     Override the default model for the selected provider\n  -h, --help              Show this help\n\nEnvironment variables:\n  OPENAI_API_KEY          API key for OpenAI\n  ANTHROPIC_API_KEY       API key for Anthropic\n  OPENROUTER_API_KEY      API key for OpenRouter\n  TLDR_SYSTEM_PROMPT      Default system prompt\n  TLDR_OPENAI_MODEL       Default OpenAI model (default: gpt-5.4-nano)\n  TLDR_ANTHROPIC_MODEL    Default Anthropic model (default: claude-4-haiku-20250305)\n  TLDR_OPENROUTER_MODEL   Default OpenRouter model (default: google/gemini-3.1-flash-lite-preview)\n\nLegacy env vars still supported:\n  SUMMARIZE_SYSTEM_PROMPT\n  SUMMARIZE_OPENAI_MODEL\n  SUMMARIZE_ANTHROPIC_MODEL\n  SUMMARIZE_OPENROUTER_MODEL\n`);
+}
+
+function fail(message, code = 1) {
+  console.error(message);
+  process.exit(code);
+}
+
+function parseArgs(argv) {
+  const args = [...argv];
+  let provider;
+  let system;
+  let model;
+  const promptParts = [];
+
+  while (args.length > 0) {
+    const arg = args.shift();
+
+    if (arg === '-h' || arg === '--help') {
+      printHelp();
+      process.exit(0);
+    }
+
+    if (arg === '-p' || arg === '--provider') {
+      provider = args.shift();
+      if (!provider) fail('Missing value for --provider');
+      continue;
+    }
+
+    if (arg.startsWith('--provider=')) {
+      provider = arg.split('=').slice(1).join('=');
+      continue;
+    }
+
+    if (arg === '-s' || arg === '--system') {
+      system = args.shift();
+      if (!system) fail('Missing value for --system');
+      continue;
+    }
+
+    if (arg.startsWith('--system=')) {
+      system = arg.split('=').slice(1).join('=');
+      continue;
+    }
+
+    if (arg === '-m' || arg === '--model') {
+      model = args.shift();
+      if (!model) fail('Missing value for --model');
+      continue;
+    }
+
+    if (arg.startsWith('--model=')) {
+      model = arg.split('=').slice(1).join('=');
+      continue;
+    }
+
+    promptParts.push(arg);
+  }
+
+  return {
+    provider,
+    system: system || DEFAULT_SYSTEM_PROMPT,
+    model,
+    prompt: promptParts.join(' ').trim()
+  };
+}
+
+function detectProvider(explicitProvider) {
+  if (explicitProvider) {
+    const normalized = explicitProvider.toLowerCase();
+    if (!['openai', 'anthropic', 'openrouter'].includes(normalized)) {
+      fail(`Unsupported provider: ${explicitProvider}`);
+    }
+    return normalized;
+  }
+
+  if (process.env.OPENAI_API_KEY) return 'openai';
+  if (process.env.ANTHROPIC_API_KEY) return 'anthropic';
+  if (process.env.OPENROUTER_API_KEY) return 'openrouter';
+
+  fail('No provider specified and no API key found in OPENAI_API_KEY, ANTHROPIC_API_KEY, or OPENROUTER_API_KEY.');
+}
+
+async function readStdinIfNeeded(prompt) {
+  if (prompt) return prompt;
+  if (process.stdin.isTTY) {
+    fail('No input provided. Pass a prompt argument or pipe text into stdin.');
+  }
+
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+
+  const input = Buffer.concat(chunks.map(chunk => Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))).toString('utf8').trim();
+  if (!input) fail('Received empty stdin input.');
+  return input;
+}
+
+function getModel(provider, explicitModel) {
+  if (explicitModel) return explicitModel;
+
+  switch (provider) {
+    case 'openai':
+      return process.env.TLDR_OPENAI_MODEL || process.env.SUMMARIZE_OPENAI_MODEL || 'gpt-5.4-nano';
+    case 'anthropic':
+      return process.env.TLDR_ANTHROPIC_MODEL || process.env.SUMMARIZE_ANTHROPIC_MODEL || 'claude-4-haiku-20250305';
+    case 'openrouter':
+      return process.env.TLDR_OPENROUTER_MODEL || process.env.SUMMARIZE_OPENROUTER_MODEL || 'google/gemini-3.1-flash-lite-preview';
+    default:
+      fail(`Unsupported provider: ${provider}`);
+  }
+}
+
+async function summarizeWithOpenAI({ apiKey, model, system, input }) {
+  const response = await fetch('https://api.openai.com/v1/chat/completions', {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json',
+      authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model,
+      messages: [
+        { role: 'system', content: system },
+        { role: 'user', content: input }
+      ]
+    })
+  });
+
+  const data = await response.json();
+  if (!response.ok) {
+    throw new Error(data?.error?.message || `OpenAI request failed with status ${response.status}`);
+  }
+
+  return data?.choices?.[0]?.message?.content?.trim() || '';
+}
+
+async function summarizeWithOpenRouter({ apiKey, model, system, input }) {
+  const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json',
+      authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model,
+      messages: [
+        { role: 'system', content: system },
+        { role: 'user', content: input }
+      ]
+    })
+  });
+
+  const data = await response.json();
+  if (!response.ok) {
+    throw new Error(data?.error?.message || `OpenRouter request failed with status ${response.status}`);
+  }
+
+  return data?.choices?.[0]?.message?.content?.trim() || '';
+}
+
+async function summarizeWithAnthropic({ apiKey, model, system, input }) {
+  const response = await fetch('https://api.anthropic.com/v1/messages', {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json',
+      'x-api-key': apiKey,
+      'anthropic-version': '2023-06-01'
+    },
+    body: JSON.stringify({
+      model,
+      system,
+      max_tokens: 1024,
+      messages: [
+        { role: 'user', content: input }
+      ]
+    })
+  });
+
+  const data = await response.json();
+  if (!response.ok) {
+    throw new Error(data?.error?.message || `Anthropic request failed with status ${response.status}`);
+  }
+
+  return (data?.content || [])
+    .filter(item => item?.type === 'text')
+    .map(item => item.text)
+    .join('\n')
+    .trim();
+}
+
+async function main() {
+  const { provider: explicitProvider, system, model: explicitModel, prompt } = parseArgs(process.argv.slice(2));
+  const provider = detectProvider(explicitProvider);
+  const input = await readStdinIfNeeded(prompt);
+  const model = getModel(provider, explicitModel);
+
+  let summary = '';
+
+  if (provider === 'openai') {
+    const apiKey = process.env.OPENAI_API_KEY;
+    if (!apiKey) fail('OPENAI_API_KEY is not set.');
+    summary = await summarizeWithOpenAI({ apiKey, model, system, input });
+  } else if (provider === 'anthropic') {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) fail('ANTHROPIC_API_KEY is not set.');
+    summary = await summarizeWithAnthropic({ apiKey, model, system, input });
+  } else if (provider === 'openrouter') {
+    const apiKey = process.env.OPENROUTER_API_KEY;
+    if (!apiKey) fail('OPENROUTER_API_KEY is not set.');
+    summary = await summarizeWithOpenRouter({ apiKey, model, system, input });
+  } else {
+    fail(`Unsupported provider: ${provider}`);
+  }
+
+  if (!summary) {
+    fail('The provider returned an empty summary.');
+  }
+
+  process.stdout.write(summary.endsWith('\n') ? summary : `${summary}\n`);
+}
+
+main().catch(error => {
+  fail(error instanceof Error ? error.message : String(error));
+});

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@camelai/tldr",
+  "version": "0.1.0",
+  "description": "CLI to summarize text with OpenAI, Anthropic, or OpenRouter",
+  "type": "module",
+  "bin": {
+    "tldr": "./bin/tldr.js"
+  },
+  "scripts": {
+    "start": "node ./bin/tldr.js"
+  },
+  "keywords": [
+    "cli",
+    "summary",
+    "tldr",
+    "openai",
+    "anthropic",
+    "openrouter"
+  ],
+  "author": "QAML AI",
+  "license": "MIT",
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qaml-ai/tldr.git"
+  },
+  "homepage": "https://github.com/qaml-ai/tldr#readme",
+  "bugs": {
+    "url": "https://github.com/qaml-ai/tldr/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}