vivream 0.1.0

package/README.md

@@ -0,0 +1,87 @@
+# Vivream
+
+**Brain-dump in. Blueprint out.**
+
+A local AI workbench that turns your raw ideas into structured plans — powered by your own Claude Code, Codex, or Agy CLI. No cloud account needed. Completely free.
+
+[![npm](https://img.shields.io/npm/v/vivream)](https://www.npmjs.com/package/vivream)
+[![GitHub Sponsors](https://img.shields.io/github/sponsors/AppSoApp?label=Sponsor&logo=githubsponsors)](https://github.com/sponsors/AppSoApp)
+[![Ko-fi](https://img.shields.io/badge/Ko--fi-donate-FF5E5B?logo=ko-fi)](https://ko-fi.com/appsoapplication)
+
+---
+
+## Quick Start
+
+```bash
+npx vivream
+```
+
+Opens automatically at `http://localhost:3001`.
+
+## Requirements
+
+- **Node.js ≥ 20**
+- One of the following AI runtimes:
+  - [Claude Code](https://claude.ai/code) (recommended)
+  - [OpenAI Codex CLI](https://github.com/openai/codex)
+  - [Agy](https://github.com/antigravityai/agy)
+  - **Or** enter a BYOK API key inside the app under Settings
+
+## How It Works
+
+1. Brain-dump your thoughts into the entry box
+2. Let the AI organize them into a structured plan
+3. Save sessions, compare ideas, and generate pitch decks
+
+All processing happens on your machine using your own AI credentials. No data leaves your device.
+
+## Support Development
+
+Vivream is free and open to use. If it saves you time, consider sponsoring:
+
+- [GitHub Sponsors](https://github.com/sponsors/AppSoApp)
+- [Ko-fi](https://ko-fi.com/appsoapplication)
+
+## Contact
+
+appsoapplication@gmail.com · [Issues](https://github.com/AppSoApp/Vivream/issues)
+
+## License
+
+MIT
+
+---
+
+## 한국어
+
+**두뇌 덤프 → 블루프린트 완성.**
+
+내 Claude Code / Codex / Agy CLI 로 구동되는 로컬 AI 워크벤치. 클라우드 계정 불필요. 완전 무료.
+
+### 시작하기
+
+```bash
+npx vivream
+```
+
+`http://localhost:3001` 이 자동으로 열립니다.
+
+### 필요 사항
+
+- **Node.js ≥ 20**
+- 아래 중 하나의 AI 런타임:
+  - [Claude Code](https://claude.ai/code) (권장)
+  - [OpenAI Codex CLI](https://github.com/openai/codex)
+  - [Agy](https://github.com/antigravityai/agy)
+  - 또는 앱 내 설정에서 BYOK API 키 입력
+
+### 후원
+
+Vivream 은 무료입니다. 도움이 됐다면 후원을 고려해 주세요:
+
+- [GitHub Sponsors](https://github.com/sponsors/AppSoApp)
+- [Ko-fi](https://ko-fi.com/appsoapplication)
+
+### 문의
+
+appsoapplication@gmail.com · [이슈](https://github.com/AppSoApp/Vivream/issues)

package/bin/cli.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawn, spawnSync } = require('child_process');
+const path = require('path');
+const net = require('net');
+const os = require('os');
+const fs = require('fs');
+
+const PKG_ROOT = path.join(__dirname, '..');
+const PKG_JSON = require(path.join(PKG_ROOT, 'package.json'));
+const VERSION = PKG_JSON.version;
+
+// npm excludes node_modules/ from published packages unconditionally,
+// so the standalone server is shipped as a tarball and extracted here on first run.
+const BUNDLE_PATH = path.join(PKG_ROOT, 'vivream-server.tar.gz');
+const CACHE_DIR = path.join(os.homedir(), '.vivream', 'cache', VERSION);
+const SERVER_PATH = path.join(CACHE_DIR, 'server.js');
+
+const DEFAULT_PORT = 3001;
+
+const isKo = /^ko/.test(process.env.LANG || process.env.LC_ALL || process.env.VIVREAM_LANG || '');
+
+const MSG = {
+  extracting: isKo ? '  번들 추출 중 (최초 1회)...' : '  Extracting bundle (first run only)...',
+  starting: isKo ? '  Vivream 시작 중...' : '  Starting Vivream...',
+  ready: (port) => isKo
+    ? `\n  ✓ 준비 완료 →  http://localhost:${port}\n\n  종료: Ctrl+C\n  문의: appsoapplication@gmail.com\n`
+    : `\n  ✓ Ready →  http://localhost:${port}\n\n  Quit: Ctrl+C\n  Contact: appsoapplication@gmail.com\n`,
+  noCli: isKo
+    ? '\n  ⚠  로컬 AI CLI 미감지 (Claude Code / Codex / Agy).\n     설치 후 재실행하거나, 앱 설정에서 BYOK API 키를 입력하세요.\n'
+    : '\n  ⚠  No local AI CLI detected (Claude Code / Codex / Agy).\n     Install one and restart, or enter a BYOK API key inside the app.\n',
+  portBusy: (p) => isKo ? `  포트 ${p} 사용 중 — 다음 포트 시도...` : `  Port ${p} in use — trying next...`,
+  error: isKo
+    ? '  서버 시작 실패. Node.js ≥20 이 설치되어 있는지 확인하세요.'
+    : '  Failed to start server. Ensure Node.js ≥20 is installed.',
+  extractError: isKo
+    ? '  번들 추출 실패. 재설치를 시도하세요: npm install -g vivream'
+    : '  Failed to extract bundle. Try reinstalling: npm install -g vivream',
+};
+
+function ensureExtracted() {
+  if (fs.existsSync(SERVER_PATH)) return;
+  if (!fs.existsSync(BUNDLE_PATH)) {
+    process.stderr.write(MSG.extractError + '\n');
+    process.exit(1);
+  }
+  process.stdout.write(MSG.extracting + '\n');
+  fs.mkdirSync(CACHE_DIR, { recursive: true });
+  const result = spawnSync('tar', ['-xzf', BUNDLE_PATH, '-C', CACHE_DIR], { stdio: 'inherit' });
+  if (result.status !== 0) {
+    process.stderr.write(MSG.extractError + '\n');
+    process.exit(1);
+  }
+}
+
+function findFreePort(start) {
+  return new Promise((resolve) => {
+    const srv = net.createServer();
+    srv.listen(start, '127.0.0.1', () => {
+      const { port } = srv.address();
+      srv.close(() => resolve(port));
+    });
+    srv.on('error', () => resolve(findFreePort(start + 1)));
+  });
+}
+
+function openBrowser(port) {
+  const url = `http://localhost:${port}`;
+  const args =
+    process.platform === 'darwin' ? ['open', [url]] :
+    process.platform === 'win32'  ? ['cmd', ['/c', 'start', '', url]] :
+    ['xdg-open', [url]];
+  try { spawnSync(args[0], args[1], { stdio: 'ignore' }); } catch { /* ignore */ }
+}
+
+function cliExists(name) {
+  const r = spawnSync(name, ['--version'], { stdio: 'ignore', shell: false });
+  return r.status === 0;
+}
+
+async function main() {
+  ensureExtracted();
+
+  if (!['claude', 'codex', 'agy'].some(cliExists)) {
+    process.stderr.write(MSG.noCli);
+  }
+
+  const port = await findFreePort(DEFAULT_PORT);
+  if (port !== DEFAULT_PORT) process.stdout.write(MSG.portBusy(DEFAULT_PORT) + '\n');
+  process.stdout.write(MSG.starting + '\n');
+
+  const server = spawn(process.execPath, [SERVER_PATH], {
+    cwd: CACHE_DIR,
+    env: { ...process.env, PORT: String(port), HOSTNAME: '127.0.0.1', NODE_ENV: 'production' },
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+
+  let ready = false;
+
+  const handleReady = () => {
+    if (ready) return;
+    ready = true;
+    process.stdout.write(MSG.ready(port));
+    setTimeout(() => openBrowser(port), 400);
+  };
+
+  server.stdout.on('data', (d) => {
+    if (/ready|started|listening/i.test(d.toString())) handleReady();
+  });
+
+  // Fallback: open browser after 3s regardless
+  setTimeout(handleReady, 3000);
+
+  server.on('error', () => { process.stderr.write(MSG.error + '\n'); process.exit(1); });
+  server.on('exit', (code) => { if (code && code !== 0) process.exit(code); });
+
+  const shutdown = () => { server.kill('SIGTERM'); setTimeout(() => process.exit(0), 500); };
+  process.on('SIGINT', shutdown);
+  process.on('SIGTERM', shutdown);
+}
+
+main().catch((e) => { process.stderr.write(String(e) + '\n'); process.exit(1); });

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "vivream",
+  "version": "0.1.0",
+  "description": "Brain-dump in. Blueprint out. — Local AI workbench powered by your own Claude / Codex / Agy CLI",
+  "keywords": ["ai", "claude", "brain-dump", "workbench", "local-first", "mindmap", "prompt"],
+  "homepage": "https://github.com/AppSoApp/Vivream",
+  "bugs": {
+    "url": "https://github.com/AppSoApp/Vivream/issues",
+    "email": "appsoapplication@gmail.com"
+  },
+  "author": {
+    "name": "AppSoApp",
+    "email": "appsoapplication@gmail.com"
+  },
+  "license": "MIT",
+  "bin": {
+    "vivream": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "vivream-server.tar.gz"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AppSoApp/Vivream.git"
+  }
+}