🌀 FlowLens — Instantly Resume Your Coding Flow

Screenshot

Website: flowlens-vscode.vercel.app | Get Extension | Security | Contributing

FlowLens helps you save your work context in Visual Studio Code and instantly resume where you left off;

open files, terminals, git branch, and notes: all restored with one click.

🚀 Installation

Install from VS Code Marketplace

Option 1: Install directly from VS Code

Open VS Code
Press Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (Mac) to open Extensions
Search for "FlowLens"
Click Install

Option 2: Install from Marketplace

Visit the FlowLens Marketplace page
Click Install

Option 3: Quick Install Command

code --install-extension preston176.flowlens

🎉 Early Access Available Now! - Be among the first to try FlowLens and help shape its future.

✨ What is FlowLens?

FlowLens is a privacy-first extension for Visual Studio Code that helps developers capture and restore their coding sessions.

Each session snapshot includes:

Open files and cursor positions
Terminal commands and state
Active git branch and commit
Optional short notes

When you return, FlowLens restores your exact editor layout, terminal setup, and focus — so you can pick up right where you left off.

📸 Demo

Screenshot

Navigate Your Sessions Effortlessly

Screenshot2

Quickly Jump Back Into Flow

Screenshot3

🛠️ Prerequisites

Visual Studio Code installed on your computer
Basic familiarity with VS Code's Command Palette

🧭 How To Use FlowLens

🪄 Capture Your Current Session

Work as usual — open files, terminals, etc.
Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac).
Search for FlowLens: Capture Session and select it.
Enter a short title (e.g. “Fixing API Bug”).
Optionally, add a quick note to describe what you were doing.
A success message confirms the capture.

🚀 View and Resume a Saved Session

Open the Command Palette again.
Search for FlowLens: Open Sessions Panel.
Browse your saved sessions in the panel.
Use the search bar to filter by title, note, or file name.
Click Resume next to any session to instantly restore your environment.

🗑️ Delete a Session

Open the FlowLens Sessions Panel.
Locate the session you want to remove.
Click Delete to permanently remove it.

✅ Expected Results

Saved sessions appear in the panel with your title and notes.
Resuming restores your files, terminals, and layout.
Deleted sessions are removed immediately and cannot be recovered.

🧩 Troubleshooting

Issue	Possible Cause	Solution
Sessions not appearing	No sessions captured yet	Capture a session and reload VS Code
Files not reopening	File moved or deleted	Check file paths and ensure access
Extension not working	Disabled or corrupt install	Re-enable or reinstall FlowLens

💡 Additional Information

FlowLens never uploads your code — only lightweight metadata (file paths, positions, git branch, notes).
All data is stored locally on your machine by default.
Optional sync (coming soon) will be end-to-end encrypted and fully opt-in.
Use notes to leave a “thought trail” for your future self.

For updates or support, visit the official website.

🛤️ Product Vision & Roadmap

Guiding Principles

🧠 Focus-first: Reduce mental overhead of restarting work.
🔒 Private by design: No code content ever leaves your device.
⚡ Fast and lightweight: Restores sessions instantly.
🧩 Cross-editor future: VS Code first; JetBrains, Neovim, and Sublime next.

Roadmap

[x] Landing page & waitlist
[x] Early Access on VS Code Marketplace 🎉
[x] Core capture & resume flow (local-only)
[ ] Encrypted cross-device sync (opt-in)
[ ] Team workflows and shareable sessions (beta)
[ ] Deep editor integrations & plugin ecosystem

⚖️ License

This repository currently contains marketing and design assets for FlowLens.
All code and assets are proprietary at this stage.

🤝 Contributing

We welcome early feedback, ideas, and collaboration!
Please read our CONTRIBUTING.md for details.

_{Built by developers obsessed with flow, focus, and frictionless coding.}