vivream 0.1.5 → 0.1.7

package/README.md

@@ -2,7 +2,7 @@
 
 **Brain-dump in. Blueprint out.**
 
-A free, local-first AI workbench that turns your raw ideas into structured plans — powered by your own Claude Code, Codex, or Agy CLI. No subscription. No cloud. Everything runs on your machine.
+A free, local-first AI workbench that turns one raw brain-dump into five structured outputs — powered by your own Claude Code, Codex, or Agy CLI. No subscription. No cloud. Everything runs on your machine.
 
 [![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)
@@ -20,6 +20,27 @@ Opens automatically at `http://localhost:3001`.
 
 ---
 
+## Features
+
+**Five outputs from one brain-dump.** Type your ideas once, generate any of:
+
+| | Output | What it's for |
+|---|---|---|
+| 📄 | **Spec** | A structured design document |
+| ▤ | **Execution prompt** | A ready-to-paste prompt for Claude Code / Cursor / ChatGPT |
+| 🌿 | **Mindmap** | A node-graph visualization of your idea |
+| `{}` | **JSON** | Structured data for system integration |
+| 🎤 | **Pitch deck** | Marp slides, targeted at investors / team / clients |
+
+- **CLI runtime selection** — Vivream detects which AI CLIs are installed on your machine (Claude Code / Codex / Agy) and shows a *detected / not installed* status. Choose a default runtime in **Settings → CLI**, or switch on the fly from the selector in the workbench header.
+- **Specialized AI roles per output** — each output mode is backed by a dedicated AI skill (e.g. Spec writes as a senior tech writer, Pitch as a startup storyteller), so the AI adopts the right voice for what you're building.
+- **Time Machine** — roll back to any previous checkpoint in your session.
+- **Cross-Pollination** — Vivream surfaces similar past sessions and suggests connections automatically.
+- **Local-first & private** — sessions live in your browser's IndexedDB, BYOK API keys are encrypted with AES-256-GCM, and every AI run happens on your own machine. No data is sent to Vivream servers.
+- **Bilingual UI (Korean / English)** — toggle the language in **Settings → General**. The landing page and settings are fully translated; the workbench is currently Korean (English coming).
+
+---
+
 ## Requirements
 
 - **Node.js ≥ 20** ([nodejs.org](https://nodejs.org))
@@ -77,10 +98,11 @@ npx vivream
 ## How It Works
 
 1. **Brain-dump** — Type your raw ideas, notes, or goals into the input box. No structure needed.
-2. **Generate** — AI organizes your dump into a structured document, mindmap, prompt, or pitch deck.
-3. **Save sessions** — Save your sessions and revisit them later.
-4. **Time Machine** — Roll back to any previous checkpoint in your session.
-5. **Cross-Pollination** — Vivream finds similar past sessions and suggests connections automatically.
+2. **Pick a runtime** — Vivream auto-detects your installed CLI, or choose one from the header selector (Claude Code / Codex / Agy / BYOK key).
+3. **Generate** — AI turns your dump into any of the five outputs: spec, execution prompt, mindmap, JSON, or pitch deck. Each mode is guided by its own specialized AI role.
+4. **Save sessions** — Save your sessions and revisit them later.
+5. **Time Machine** — Roll back to any previous checkpoint in your session.
+6. **Cross-Pollination** — Vivream finds similar past sessions and suggests connections automatically.
 
 All AI processing happens on your machine using your own credentials. No data is sent to Vivream servers.
 
@@ -88,6 +110,12 @@ All AI processing happens on your machine using your own credentials. No data is
 
 ## Settings
 
+### CLI runtime (Settings → CLI)
+See which AI CLIs are installed (*detected / not installed*) and choose your default runtime. Priority order: your explicit choice (header selector or saved default) → auto-detected CLI (Claude → Codex → Agy) → BYOK API key. You can also switch runtimes any time from the selector in the workbench header.
+
+### Language (Settings → General)
+Toggle the UI language between **한국어** and **English**. The landing page and settings are fully translated; the workbench is currently Korean (English translation in progress).
+
 ### BYOK (Bring Your Own Key)
 If you don't have Claude Code / Codex / Agy installed, you can use an API key directly:
 
@@ -95,7 +123,7 @@ If you don't have Claude Code / Codex / Agy installed, you can use an API key di
 2. Go to **Settings → BYOK**
 3. Enter your Anthropic API key
 
-Get an API key at [console.anthropic.com](https://console.anthropic.com)
+Keys are encrypted with AES-256-GCM. Get an API key at [console.anthropic.com](https://console.anthropic.com).
 
 ### Port
 Default port is `3001`. If it's in use, Vivream automatically tries the next available port.
@@ -105,7 +133,7 @@ Default port is `3001`. If it's in use, Vivream automatically tries the next ava
 ## Troubleshooting
 
 **"No local AI CLI detected"**  
-→ Install Claude Code, Codex CLI, or Agy — or add a BYOK API key in Settings.
+→ Install Claude Code, Codex CLI, or Agy — or add a BYOK API key in Settings. Check **Settings → CLI** to see what's detected.
 
 **Browser doesn't open automatically**  
 → Navigate to `http://localhost:3001` manually.
@@ -141,7 +169,7 @@ MIT
 
 **아이디어를 쏟아내세요. 설계도로 바꿔드립니다.**
 
-Claude Code / Codex / Agy CLI 로 구동되는 무료 로컬 AI 워크벤치. 구독 없음. 클라우드 없음. 내 컴퓨터에서 전부 실행.
+하나의 브레인덤프를 다섯 가지 구조화된 결과물로 바꿔주는 무료 로컬 AI 워크벤치. Claude Code / Codex / Agy CLI 로 구동. 구독 없음. 클라우드 없음. 내 컴퓨터에서 전부 실행.
 
 ### 시작하기
 
@@ -151,13 +179,32 @@ npx vivream
 
 `http://localhost:3001` 이 자동으로 열립니다.
 
+### 핵심 기능
+
+**한 번의 덤프 → 다섯 가지 결과물.** 아이디어를 한 번 입력하면 아래 중 무엇이든 생성할 수 있습니다:
+
+| | 결과물 | 용도 |
+|---|---|---|
+| 📄 | **설계서** | 구조화된 설계 문서 |
+| ▤ | **실행 프롬프트** | Claude Code / Cursor / ChatGPT 에 그대로 붙여넣는 프롬프트 |
+| 🌿 | **마인드맵** | 아이디어를 노드 그래프로 시각화 |
+| `{}` | **JSON** | 시스템 연동용 구조화 데이터 |
+| 🎤 | **피치 덱** | 투자자 · 팀 · 클라이언트 대상 Marp 슬라이드 |
+
+- **CLI 런타임 선택** — 내 컴퓨터에 설치된 AI CLI(Claude Code / Codex / Agy)를 자동 감지해 *감지됨 / 미설치* 상태로 보여줍니다. **설정 → CLI** 에서 기본 런타임을 고르거나, 워크벤치 헤더의 선택기에서 즉시 전환할 수 있습니다.
+- **결과물별 전용 AI 역할** — 각 출력 모드마다 전담 AI 스킬이 붙습니다(예: 설계서는 시니어 테크 라이터, 피치는 스타트업 스토리텔러). 만들려는 결과물에 맞는 목소리로 AI 가 작동합니다.
+- **Time Machine** — 세션의 이전 체크포인트로 롤백.
+- **Cross-Pollination** — 과거 유사 세션을 찾아 자동으로 연결을 제안.
+- **로컬 우선 & 프라이버시** — 세션은 브라우저 IndexedDB 에 저장되고, BYOK API 키는 AES-256-GCM 으로 암호화되며, 모든 AI 실행이 내 컴퓨터에서 일어납니다. Vivream 서버로 데이터를 보내지 않습니다.
+- **한/영 UI 전환** — **설정 → 일반** 에서 언어를 바꿀 수 있습니다. 랜딩 페이지와 설정은 완전히 번역되어 있고, 워크벤치는 현재 한국어입니다(영문은 작업 중).
+
 ### 필요 사항
 
 - **Node.js ≥ 20** ([nodejs.org](https://nodejs.org))
 - 아래 중 하나:
   - **Claude Code** (권장) — [claude.ai/code](https://claude.ai/code)
   - **OpenAI Codex CLI** — `npm install -g @openai/codex`
-  - **Agy**
+  - **Agy** — [antigravity.ai](https://antigravity.ai)
   - **BYOK** — 앱 내 설정 → BYOK에서 API 키 입력
 
 ### 설치 방법
@@ -183,10 +230,18 @@ npx vivream
 ### 사용법
 
 1. **입력창에 아이디어 덤프** — 형식 없이 자유롭게 입력
-2. **생성 버튼 클릭** — AI가 문서/마인드맵/프롬프트/피치덱으로 정리
-3. **세션 저장** — 이전 작업 저장 및 재방문
-4. **Time Machine** — 이전 체크포인트로 롤백
-5. **Cross-Pollination** — 과거 유사 세션 자동 추천
+2. **런타임 선택** — 설치된 CLI 를 자동 감지하거나, 헤더 선택기에서 직접 선택 (Claude Code / Codex / Agy / BYOK 키)
+3. **생성 버튼 클릭** — AI 가 다섯 결과물(설계서 · 실행 프롬프트 · 마인드맵 · JSON · 피치 덱) 중 원하는 것으로 정리. 모드마다 전용 AI 역할이 작동
+4. **세션 저장** — 이전 작업 저장 및 재방문
+5. **Time Machine** — 이전 체크포인트로 롤백
+6. **Cross-Pollination** — 과거 유사 세션 자동 추천
+
+### 설정
+
+- **CLI 런타임 (설정 → CLI)** — 설치된 CLI 의 *감지됨 / 미설치* 상태 확인 및 기본 런타임 선택. 우선순위: 명시 선택(헤더 선택기 또는 저장된 기본값) → 자동 감지 CLI(claude → codex → agy 순) → BYOK API 키. 헤더 선택기에서 언제든 전환 가능.
+- **언어 (설정 → 일반)** — UI 언어를 **한국어 / English** 로 전환. 랜딩 페이지와 설정은 완전 번역, 워크벤치는 현재 한국어(영문 작업 중).
+- **BYOK (설정 → BYOK)** — Claude Code / Codex / Agy 없이 Anthropic API 키를 직접 사용. 키는 AES-256-GCM 으로 암호화 저장. [console.anthropic.com](https://console.anthropic.com) 에서 키 발급.
+- **포트** — 기본 포트는 `3001`. 사용 중이면 다음 가용 포트를 자동으로 시도.
 
 ### 후원
 

package/bin/cli.js

@@ -95,7 +95,7 @@ async function main() {
 
   const server = spawn(process.execPath, [SERVER_PATH], {
     cwd: CACHE_DIR,
-    env: { ...process.env, PORT: String(port), HOSTNAME: '127.0.0.1', NODE_ENV: 'production' },
+    env: { ...process.env, PORT: String(port), HOSTNAME: '127.0.0.1', NODE_ENV: 'production', VIVREAM_ENABLE_CLI_RUNTIME: 'true' },
     stdio: ['ignore', 'pipe', 'pipe'],
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vivream",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "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",