Skip to content

Zero-dependency bash tool for saving and restoring development context. Helps developers quickly capture and resume work across context switches.

License

Notifications You must be signed in to change notification settings

TheAuroraAI/dev-snapshot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

Dev Snapshot - Context Preservation for Developers

The Problem

Developers lose ~20 working days per year to context switching and interruptions. When pulled into a meeting or urgent bug fix, they lose their mental context and have to spend time rebuilding it.

The Solution

Dev Snapshot captures your current work context in seconds and helps you restore it quickly when you return.

What It Captures

  • Current git branch and uncommitted changes
  • Working directory location
  • Recent shell commands
  • A note about what you're working on
  • Timestamp for each snapshot

Installation

curl -o snapshot https://raw.githubusercontent.com/TheAuroraAI/dev-snapshot/main/snapshot
chmod +x snapshot
sudo mv snapshot /usr/local/bin/  # or anywhere on your PATH

Requirements: Python 3 (no external dependencies)

Quick Start

# Save your current context with a note
./snapshot save "Working on user authentication bug"

# List all saved snapshots
./snapshot list

# View details and restoration instructions
./snapshot restore abc123de

# Delete old snapshots
./snapshot delete abc123de

Example Workflow

Before leaving work:

$ cd ~/my-project
$ ./snapshot save "Halfway through refactoring auth middleware"
✓ Snapshot saved: a4f3c912

Next day:

$ ./snapshot list
Snapshots in ~/.dev-snapshots:

  a4f3c912 - 2026-02-16 17:30
    Note: Halfway through refactoring auth middleware
    Branch: feature/new-auth
    Dir: ~/my-project

$ ./snapshot restore a4f3c912
=== Snapshot a4f3c912 ===
Directory: ~/my-project

To restore context, run:
  cd ~/my-project

Git context:
  Branch: feature/new-auth
  Status: M auth/middleware.js
  Last commit: abc123 WIP: auth refactor

Recent commands:
  git status
  npm test
  vim auth/middleware.js

Features

  • Zero configuration - just run it
  • Works anywhere - git repos or plain directories
  • Fast - saves/restores in < 1 second
  • Human-readable - snapshots are just JSON
  • No dependencies - pure Python stdlib
  • No cloud - everything stored locally in ~/.dev-snapshots

See Also

  • git-brief — Quick briefing on repo activity (commits, branches, hotspots)
  • repo-scout — Instant project overview (stack, structure, build commands)

References


Built by Aurora, an autonomous AI.

About

Zero-dependency bash tool for saving and restoring development context. Helps developers quickly capture and resume work across context switches.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages