FlowLog

Git stash for your mental context.

FlowLog is a passive working-memory capture tool for VS Code. It silently records your session activity in the background and presents a Resume Card when you need to pick up where you left off. No configuration, no telemetry, no cloud — just local context that stays with your project.

Why FlowLog?

You close VS Code on Friday. You reopen it on Monday. What were you doing? Which files mattered? What was that thing you were about to fix?

FlowLog answers all of that automatically:

• Zero effort — it runs silently in the background from the moment you open a workspace.
• Resume Card — a single view showing your most active files, notes, and timeline.
• Quick Notes — capture a thought in under 2 seconds with a keyboard shortcut.
• Handoff Export — generate a Markdown summary to paste into Slack, Jira, or a PR description.

Features

Passive Session Tracking

FlowLog quietly listens to your editor activity:

All events are timestamped and stored locally in .vscode/flowlog/ inside your workspace.

Quick Notes (Ctrl+Shift+N / Cmd+Shift+N)

Capture a thought without breaking your flow. A lightweight input box appears, you type a line, and it's saved with a timestamp into your session log.

"Debugging the auth middleware timeout — suspect the retry logic in handleRefresh()"

Resume Card

Open the command palette and run FlowLog: Show Resume Card to see:

• Active Files — ranked by time spent, so you know where your focus was.
• Last Quick Note — the most recent note you left yourself.
• Timeline — a chronological view of your last 10 tracked events.

Handoff Export

Run FlowLog: Export Handoff to generate a clean Markdown document summarizing your day:

• Files worked on (with time spent)
• All quick notes taken
• Activity timeline

The Markdown opens in a new editor tab — ready to copy into a standup update, PR description, or team channel.

Commands

Data & Privacy

FlowLog is 100% local.

• All data is stored in .vscode/flowlog/ inside your workspace.
• Zero telemetry. Nothing is sent anywhere.
• Zero external dependencies. No network calls, no cloud services.
• Add .vscode/flowlog/ to your .gitignore if you don't want session data in version control.

Installation

From Source

git clone https://github.com/Faze789/FlowLog.git
cd FlowLog
npm install
npm run compile

Then press F5 in VS Code to launch the Extension Development Host.

VS Code Marketplace

Coming soon.

Configuration

None required. FlowLog activates automatically when you open a workspace and starts tracking immediately.

Roadmap

• [ ] Auto-show Resume Card on workspace open
• [ ] Configurable tracking granularity
• [ ] Multi-root workspace support
• [ ] Session history (browse past days)
• [ ] VS Code Marketplace publishing

Contributing

Contributions are welcome! Please open an issue first to discuss what you'd like to change.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/my-feature)
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

License

MIT