Skip to content

AppSoApp/Vivream

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

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.

npm GitHub Sponsors Ko-fi


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
  • 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)
  • 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
  1. 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
  1. Open Terminal and run:
npx vivream
  1. 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. 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:

  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 (~13MB) to ~/.vivream/cache/. Subsequent runs start instantly.


Support Development

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


Contact

appsoapplication@gmail.com Β· Issues

License

MIT


ν•œκ΅­μ–΄

아이디어λ₯Ό μŸμ•„λ‚΄μ„Έμš”. μ„€κ³„λ„λ‘œ λ°”κΏ”λ“œλ¦½λ‹ˆλ‹€.

ν•˜λ‚˜μ˜ λΈŒλ ˆμΈλ€ν”„λ₯Ό λ‹€μ„― κ°€μ§€ κ΅¬μ‘°ν™”λœ 결과물둜 λ°”κΏ”μ£ΌλŠ” 무료 둜컬 AI μ›Œν¬λ²€μΉ˜. Claude Code / Codex / Agy CLI 둜 ꡬ동. ꡬ독 μ—†μŒ. ν΄λΌμš°λ“œ μ—†μŒ. λ‚΄ μ»΄ν“¨ν„°μ—μ„œ μ „λΆ€ μ‹€ν–‰.

μ‹œμž‘ν•˜κΈ°

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)
  • μ•„λž˜ 쀑 ν•˜λ‚˜:
    • 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 μ‹€ν–‰

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 둜 μ „ν™˜. λžœλ”© νŽ˜μ΄μ§€μ™€ 섀정은 μ™„μ „ λ²ˆμ—­, μ›Œν¬λ²€μΉ˜λŠ” ν˜„μž¬ ν•œκ΅­μ–΄(영문 μž‘μ—… 쀑).
  • BYOK (μ„€μ • β†’ BYOK) β€” Claude Code / Codex / Agy 없이 Anthropic API ν‚€λ₯Ό 직접 μ‚¬μš©. ν‚€λŠ” AES-256-GCM 으둜 μ•”ν˜Έν™” μ €μž₯. console.anthropic.com μ—μ„œ ν‚€ λ°œκΈ‰.
  • 포트 β€” κΈ°λ³Έ ν¬νŠΈλŠ” 3001. μ‚¬μš© 쀑이면 λ‹€μŒ κ°€μš© 포트λ₯Ό μžλ™μœΌλ‘œ μ‹œλ„.

후원

문의

appsoapplication@gmail.com · 이슈

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors