LocalHub - Time Machine for Code

LocalHub is automatic local version history for VS Code and VS Code-based IDEs. It keeps snapshots of your files in the background, shows what changed, and lets you recover code without manually creating Git commits.

Preview release: this Marketplace package stays lightweight while the Control Center runtime is downloaded automatically when needed.

Website

What's New in 3.0.7

Fixed Delete ALL (With Snapshots) for TM Groups: deleted groups now move to Zombie Trash, their files disappear from the group tree, and restore relinks the hidden snapshots correctly.
Added startup repair for existing databases where zombie TM Groups still had snapshots attached after deletion.
Removed the duplicate GW Storage Settings card from LocalHub Settings; Global Watcher keeps its own storage controls in the Global Watcher panel.
Added the current project name to LocalHub sidebar section headers so it is easier to see which workspace is active.
Kept the lightweight Marketplace package with Control Center runtime auto-download.

What It Does

Automatic file snapshots on save, editing pauses, tab switches, focus loss, idle time, external changes, and deletion.
File history with diff, restore, starred versions, version descriptions, and deleted-file recovery.
TM Groups: commit-like groups for related local changes, with tags and optional AI descriptions.
Branch-style local timelines with recovery for deleted branches and deleted groups.
Diff Navigator with accept/reject decisions for individual code blocks.
Rejected Blocks Trash so discarded code can be recovered later.
Global Watcher for background OS-level file monitoring outside the IDE.
Backup, cloud sync options, Git/GitHub integration, CLI, built-in console, plugins, and API endpoints.
AI-focused safeguards including Agent Diary and deletion protection for trash/history.

Screenshots

LocalHub sidebar with file history, TM Groups, and branches
LocalHub sidebar: file history, TM Groups, branches, trash, dashboard, and graph tools inside VS Code.

LocalHub Global Watcher dashboard
Global Watcher: background monitoring for folders, snapshots, storage, and daemon status.

Installation

From Visual Studio Marketplace

Open VS Code Quick Open with Ctrl+P, paste this command, and press Enter:

ext install IslamChomaev.localhub-time-machine

Requirements

VS Code 1.85+ or a VS Code-based IDE.
Python 3.9+ with pip.

Python dependencies are installed automatically on first run.

Quick Start

Install the extension.
Open a project folder in VS Code.
Start editing files.
LocalHub creates snapshots automatically in the background.
Use the LocalHub sidebar to inspect history, diffs, groups, branches, trash, and recovery tools.

Useful shortcuts:

Shortcut	Action
`Ctrl+Alt+S`	Create manual snapshot
`Ctrl+Alt+H`	Open feature hub
`Ctrl+Alt+L`	Open built-in LH console
`Ctrl+Alt+B`	Create branch
`Ctrl+Alt+T`	Open trash

Preview Build

This Marketplace package is marked as Preview while the lightweight Control Center auto-download flow is being finalized.

The VSIX does not bundle the heavy Control Center runtime. On first launch, LocalHub checks whether the runtime is present and downloads localhub-tray-runtime-win32-x64.zip automatically when needed.

Core extension features remain inside the VS Code extension: snapshots, history, TM Groups, branches, diff tools, AI features, Global Watcher bridge, MCP, CLI, plugins, and UI panels.

LocalHub Functionality

History and Recovery

Create automatic and manual snapshots.
Compare any version with the current file.
Restore a full file or selected blocks.
Keep deleted files in trash with configurable retention.
Star important versions to protect them from cleanup.

TM Groups

Confirm related changes as one group.
Add automatic and manual tags.
Search groups by tag or description.
Generate AI summaries when configured.
Recover deleted groups from Zombie Commits.

Branches

Create local timeline branches.
Switch between branches.
Merge or selectively bring changes across branches.
Keep deleted branches recoverable as Zombie Branches.
Export and import branch state.

Diff Navigator

Review changed blocks one by one.
Accept or reject individual blocks.
Apply only selected decisions.
Save rejected code in Rejected Blocks Trash for later recovery.

Global Watcher

Monitor selected folders even when the IDE is not active.
Transfer global watcher data into LocalHub project history.
Show watched folders, snapshot count, storage usage, and daemon status.

AI and Automation

Agent Diary logs AI-agent activity into readable project notes.
AI deletion protection prevents agents from erasing trash/history.
Storm Code integration can create LocalHub/Git commits from agent completion signals.
Smart analytics include activity heatmaps, dependency views, change velocity, and clustering.

CLI

lh status
lh log [file]
lh diff <file>
lh restore <file>
lh branch
lh branch trash
lh group
lh group trash
lh rejected
lh surgery <file>
lh ignore <file>
lh tag <group>
lh search <tag>
lh push

LocalHub - Машина времени для кода

LocalHub - это автоматическая локальная история версий для VS Code и IDE на базе VS Code. Расширение сохраняет снимки файлов в фоне, показывает изменения и помогает вернуть код без ручных Git-коммитов.

Предварительная версия: Marketplace-пакет остается легким, а Control Center runtime скачивается автоматически при необходимости.

Что нового в 3.0.7

Исправлено Delete ALL (With Snapshots) для TM Groups: удаленная группа уходит в Zombie Trash, файлы пропадают из дерева группы, а восстановление заново привязывает скрытые снимки.
Добавлен repair при старте для старых баз, где zombie TM Group уже была сломана и snapshots оставались привязанными.
Убран дублирующий блок GW Storage Settings из LocalHub Settings; настройки хранения остаются в панели Global Watcher.
Имя текущего проекта показывается в верхних секциях LocalHub sidebar.
Marketplace-пакет остается легким, Control Center runtime скачивается автоматически.

Что умеет LocalHub

Автоматически создает снимки файлов при сохранении, паузе в редактировании, переключении вкладок, потере фокуса, простое, внешних изменениях и удалении.
Показывает историю файла, diff, восстановление, избранные версии, описания версий и корзину удаленных файлов.
Собирает связанные изменения в TM Groups - локальные группы, похожие на коммиты.
Поддерживает локальные ветки истории, Zombie Branches и Zombie Commits для восстановления удаленных веток и групп.
Дает Diff Navigator: можно принять или отклонить отдельные блоки изменений.
Хранит отклоненные куски кода в Rejected Blocks Trash.
Следит за папками через Global Watcher даже вне активной IDE.
Поддерживает бэкап, облачную синхронизацию, Git/GitHub, CLI, встроенную консоль, плагины и API.
Защищает историю и корзину от случайного удаления AI-агентами.

Установка

В VS Code нажмите Ctrl+P, вставьте команду и нажмите Enter:

ext install IslamChomaev.localhub-time-machine

Требования:

VS Code 1.85+ или IDE на базе VS Code.
Python 3.9+ с pip.

Python-зависимости устанавливаются автоматически при первом запуске.

Быстрый старт

Установите расширение.
Откройте проект в VS Code.
Работайте с файлами как обычно.
LocalHub будет создавать снимки автоматически.
В сайдбаре LocalHub можно смотреть историю, diff, группы, ветки, корзину и восстановление.

Основные разделы

История файлов и восстановление.
TM Groups для связанных изменений.
Ветки и восстановление удаленных веток.
Diff Navigator и корзина отклоненных блоков.
Global Watcher для фонового мониторинга папок.
Agent Diary, AI-защита, аналитика, CLI и плагины.

Author

Islam Dev

Every change is a save point. Never lose your code.

LocalHub - Time Machine

Islam Chomaev