Vivream

Brain-dump in. Blueprint out.

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.

Quick Start

npx vivream

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 |

• A living document, not a one-shot — one session = one evolving idea. Keep dumping thoughts; every Organize (⌘G) rebuilds a single spec from all your accumulated notes — it grows, it never resets to just the latest note. Click any open question or next-step in the spec and the AI drafts an answer grounded in your current spec; accept it and it folds back into the next pass.
• Companion mode → live mindmap → plan — brainstorming now lives right in the workbench (no separate page). Drop ideas into the stream one at a time; flip on Companion mode and every 5 notes the AI leaves a cycle summary inline while the mindmap grows live. Hit Organize (⌘G) and everything clusters into a hierarchical mindmap (themes → ideas) plus a draft spec — no magic words to memorize. Mobile gets a stream ⇄ mindmap toggle.
• 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.
• Free, supported by donations — every feature is free for everyone, no subscription. If it helps you, support development via GitHub Sponsors or a one-time donation.
• 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. Landing, settings, workbench, output panels, and API error messages are all fully translated. Browser locale is auto-detected via Accept-Language on first visit.
• Windows-hardened — CLIs are reliably detected and launched on Windows (.cmd shim spawning, CVE-2024-27980); the server bundle ships with short file paths so it extracts cleanly even without long-path support (no 260-char MAX_PATH failures), and the launcher defaults to English console output on Windows to avoid Korean mojibake (CP949) — the in-browser UI stays fully Korean.

Requirements

• Node.js ≥ 20 (nodejs.org)
• One AI runtime (pick one):

| Runtime | How to get it | |---|---| | Claude Code (recommended) | claude.ai/code | | OpenAI Codex CLI | npm install -g @openai/codex | | Agy | antigravity.ai | | BYOK API Key | Enter inside the app under Settings → BYOK |

Installation by OS

Windows

1. Install Node.js from nodejs.org (LTS version)
2. Open PowerShell or Command Prompt
3. Run:

npx vivream

4. Browser opens automatically at http://localhost:3001

If npx is not found, restart the terminal after installing Node.js.

macOS

1. Install Node.js:

brew install node
# or download from nodejs.org

2. Open Terminal and run:

npx vivream

3. Browser opens automatically at http://localhost:3001

Linux

# Install Node.js 20+ (if not already installed)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Run Vivream
npx vivream

How It Works

1. Brain-dump — Type your raw ideas, notes, or goals into the input box. No structure needed.
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. Generate one output, or hit Generate all remaining to fill every tab in one go. The runtime selector shows which CLI is active (e.g. Auto · Claude).
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.

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. Landing, settings, workbench, output panels, and API error messages are all fully translated. Browser locale is auto-detected via Accept-Language on first visit (cookie wins thereafter).

BYOK (Bring Your Own Key)

If you don't have Claude Code / Codex / Agy installed, you can use an API key directly:

1. Open http://localhost:3001
2. Go to Settings → BYOK
3. Enter your Anthropic API key

Keys are encrypted with AES-256-GCM. Get an API key at console.anthropic.com.

Port

Default port is 3001. If it's in use, Vivream automatically tries the next available port.

Troubleshooting

"No local AI CLI detected"
→ 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.

Port already in use
→ Vivream will automatically find the next free port. Check the terminal output for the actual URL.

First run is slow
→ The first run extracts the server bundle (~14MB) to ~/.vivream/cache/. Subsequent runs start instantly.

Korean text looks garbled in the terminal (Windows)
→ The CLI defaults to English on Windows to avoid console code-page (CP949) mojibake — the app UI in your browser is always fully Korean regardless. To force Korean CLI messages, use Windows Terminal or PowerShell 7 and set VIVREAM_LANG=ko (the launcher then switches the console to UTF-8 automatically).

Support Development

Vivream is free and open to use. If it saves you time, consider sponsoring:

• GitHub Sponsors
• Ko-fi

Contact

[email protected] · Issues

License

MIT

한국어

아이디어를 쏟아내세요. 설계도로 바꿔드립니다.

하나의 브레인덤프를 다섯 가지 구조화된 결과물로 바꿔주는 무료 로컬 AI 워크벤치. Claude Code / Codex / Agy CLI 로 구동. 구독 없음. 클라우드 없음. 내 컴퓨터에서 전부 실행.

시작하기

npx vivream

http://localhost:3001 이 자동으로 열립니다.

핵심 기능

한 번의 덤프 → 다섯 가지 결과물. 아이디어를 한 번 입력하면 아래 중 무엇이든 생성할 수 있습니다:

| | 결과물 | 용도 | |---|---|---| | 📄 | 설계서 | 구조화된 설계 문서 | | ▤ | 실행 프롬프트 | Claude Code / Cursor / ChatGPT 에 그대로 붙여넣는 프롬프트 | | 🌿 | 마인드맵 | 아이디어를 노드 그래프로 시각화 | | {} | JSON | 시스템 연동용 구조화 데이터 | | 🎤 | 피치 덱 | 투자자 · 팀 · 클라이언트 대상 Marp 슬라이드 |

• 일회성이 아닌 살아있는 문서 — 한 세션 = 발전하는 하나의 아이디어. 계속 생각을 쏟아내면 정리(⌘G)를 누를 때마다 누적된 전체 메모 로 하나의 설계서를 다시 만들어 줍니다 — 발전할 뿐, 마지막 입력만으로 초기화되지 않습니다. 설계서의 미해결 질문·다음 단계를 클릭하면 AI 가 현재 설계서 맥락에 근거한 답변 초안을 제안하고, 받아들이면 다음 정리에 반영됩니다.
• 동행 모드 → 라이브 마인드맵 → 기획 — 브레인스토밍이 이제 워크벤치 안에 있습니다(별도 페이지 없음). 흐름에 아이디어를 하나씩 던지고 동행 모드 를 켜면, 5개마다 AI 가 사이클 요약을 스트림에 인라인으로 남기고 마인드맵이 실시간으로 자랍니다. 정리(⌘G)를 누르면 전체가 계층 마인드맵(주제 → 아이디어) + 초안 기획서로 묶입니다 — 외울 매직워드 없이. 모바일은 흐름 ⇄ 마인드맵 토글 제공.
• CLI 런타임 선택 — 내 컴퓨터에 설치된 AI CLI(Claude Code / Codex / Agy)를 자동 감지해 감지됨 / 미설치 상태로 보여줍니다. 설정 → CLI 에서 기본 런타임을 고르거나, 워크벤치 헤더의 선택기에서 즉시 전환할 수 있습니다.
• 결과물별 전용 AI 역할 — 각 출력 모드마다 전담 AI 스킬이 붙습니다(예: 설계서는 시니어 테크 라이터, 피치는 스타트업 스토리텔러). 만들려는 결과물에 맞는 목소리로 AI 가 작동합니다.
• Time Machine — 세션의 이전 체크포인트로 롤백.
• Cross-Pollination — 과거 유사 세션을 찾아 자동으로 연결을 제안.
• 무료 · 후원으로 운영 — 모든 기능이 누구에게나 무료, 구독 없음. 도움이 됐다면 GitHub Sponsors 또는 일회성 후원으로 개발을 응원해 주세요.
• 로컬 우선 & 프라이버시 — 세션은 브라우저 IndexedDB 에 저장되고, BYOK API 키는 AES-256-GCM 으로 암호화되며, 모든 AI 실행이 내 컴퓨터에서 일어납니다. Vivream 서버로 데이터를 보내지 않습니다.
• 한/영 UI 전환 — 설정 → 일반 에서 언어를 바꿀 수 있습니다. 랜딩 · 설정 · 워크벤치 · 산출물 패널 · API 에러 메시지까지 모두 번역 완료. 첫 방문 시 브라우저 Accept-Language 자동 감지 (이후 쿠키 우선).
• Windows 견고화 — Windows 에서 CLI 감지·실행 안정화(.cmd shim 스폰, CVE-2024-27980), 서버 번들 파일 경로를 짧게 만들어 long-path 설정 없이도 260자 MAX_PATH 추출 실패를 방지, 그리고 런처가 Windows 에서 기본 영어 출력으로 콘솔 한글 깨짐(CP949)을 차단합니다 — 브라우저 앱 UI 는 항상 한국어 그대로입니다.

필요 사항

• Node.js ≥ 20 (nodejs.org)
• 아래 중 하나:
  • Claude Code (권장) — claude.ai/code
  • OpenAI Codex CLI — npm install -g @openai/codex
  • Agy — antigravity.ai
  • BYOK — 앱 내 설정 → BYOK에서 API 키 입력

설치 방법

Windows

1. nodejs.org에서 Node.js 설치
2. PowerShell 또는 명령 프롬프트 열기
3. npx vivream 실행

터미널 한글이 깨져 보이면: Windows 에선 CLI 시작 메시지가 기본 영어입니다(콘솔 인코딩 깨짐 회피). 브라우저 앱 UI 는 항상 한국어입니다. 한국어 CLI 메시지를 원하면 Windows Terminal / PowerShell 7 에서 VIVREAM_LANG=ko 를 설정하세요(런처가 콘솔을 UTF-8 로 전환).

macOS

brew install node
npx vivream

Linux

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npx vivream

사용법

1. 입력창에 아이디어 덤프 — 형식 없이 자유롭게 입력
2. 런타임 선택 — 설치된 CLI 를 자동 감지하거나, 헤더 선택기에서 직접 선택 (Claude Code / Codex / Agy / BYOK 키)
3. 생성 버튼 클릭 — AI 가 다섯 결과물(설계서 · 실행 프롬프트 · 마인드맵 · JSON · 피치 덱) 중 원하는 것으로 정리. 모드마다 전용 AI 역할이 작동. 하나씩 생성하거나 나머지 모두 생성 으로 모든 탭을 한 번에 채울 수 있고, 런타임 선택기가 현재 활성 CLI 를 표시합니다(예: 자동 · Claude)
4. 세션 저장 — 이전 작업 저장 및 재방문
5. Time Machine — 이전 체크포인트로 롤백
6. Cross-Pollination — 과거 유사 세션 자동 추천

설정

• CLI 런타임 (설정 → CLI) — 설치된 CLI 의 감지됨 / 미설치 상태 확인 및 기본 런타임 선택. 우선순위: 명시 선택(헤더 선택기 또는 저장된 기본값) → 자동 감지 CLI(claude → codex → agy 순) → BYOK API 키. 헤더 선택기에서 언제든 전환 가능.
• 언어 (설정 → 일반) — UI 언어를 한국어 / English 로 전환. 랜딩 · 설정 · 워크벤치 · 산출물 패널 · API 에러 메시지까지 모두 번역 완료. 첫 방문 시 브라우저 Accept-Language 자동 감지 (이후 쿠키 우선).
• BYOK (설정 → BYOK) — Claude Code / Codex / Agy 없이 Anthropic API 키를 직접 사용. 키는 AES-256-GCM 으로 암호화 저장. console.anthropic.com 에서 키 발급.
• 포트 — 기본 포트는 3001. 사용 중이면 다음 가용 포트를 자동으로 시도.

후원

• GitHub Sponsors
• Ko-fi

문의

[email protected] · 이슈