Skip to content

ahadkhan9/workspace-mirror-skill

workspace-mirror

Verified

Sync and backup Antigravity IDE sessions, transcripts, SQLite database metadata, and brain artifacts locally into a structured workspace directory (.gemini-local/) with a rich interactive viewer.html page. Use this skill whenever the user mentions backups, workspace syncing, fswatch real-time mirroring, viewing transcripts offline, inspecting database schemas, or when they want to set up an offline viewer for their sessions.

Workspace Mirror Skill

This skill allows Antigravity agents to automatically discover, mirror, and back up conversation history and IDE artifacts for the current workspace into a human-readable local folder (.gemini-local/).

It also compiles an interactive local HTML viewer (.gemini-local/viewer.html) with all synced data pre-embedded (so no folder picker or local server is needed to view it).


When to Trigger

  • When the user asks to sync, backup, mirror, or save their current workspace history/session data.
  • When the user asks for a local viewer, HTML interface, offline transcript browser, or to inspect SQLite database tables in a rich dashboard.
  • When the user wants to set up file-watching with fswatch to auto-commit sync changes.

Usage Instructions

The skill bundles a self-contained, dependency-free Python script mirror.py inside its scripts/ directory.

Running the Mirror

Run the mirror script on behalf of the user using the run_command tool. By default, the script detects the current directory as the active workspace, but you can explicitly pass a workspace path.

  1. One-shot sync (Standard):

    • macOS / Linux:
      python3 ~/.gemini/config/skills/workspace-mirror/scripts/mirror.py
      
    • Windows (PowerShell):
      python $env:USERPROFILE\.gemini\config\skills\workspace-mirror\scripts\mirror.py
      
  2. Watch mode (Real-time auto-sync): Automatically watches the conversation database folder and triggers updates whenever a step finishes. (Requires fswatch to be installed on the system):

    • macOS / Linux:
      python3 ~/.gemini/config/skills/workspace-mirror/scripts/mirror.py --watch
      
  3. Force re-sync: Forces all conversations associated with this workspace to be re-processed:

    • macOS / Linux:
      python3 ~/.gemini/config/skills/workspace-mirror/scripts/mirror.py --force
      
    • Windows (PowerShell):
      python $env:USERPROFILE\.gemini\config\skills\workspace-mirror\scripts\mirror.py --force
      
  4. Target specific workspace:

    • macOS / Linux:
      python3 ~/.gemini/config/skills/workspace-mirror/scripts/mirror.py --workspace "/path/to/workspace"
      
    • Windows (PowerShell):
      python $env:USERPROFILE\.gemini\config\skills\workspace-mirror\scripts\mirror.py --workspace "C:\path\to\workspace"
      

Output Structure

Running the mirror creates a .gemini-local/ directory inside the target workspace containing:

  • viewer.html: A standalone, zero-click interactive interface containing all transcripts, database schema layouts, and inline media previewers.
  • index.md: A master index markdown linking all session logs.
  • sessions/: Folders organized by session ID containing:
    • transcript.md: Transcripts rendered as markdown chat bubbles.
    • conversation.md: Metadata logs and SQLite table row counts.
    • artifacts/: Local copies of all created artifacts and images.
    • raw/: Backup of the raw .db binary files.

Recommended Practices

  1. Add to Git: Recommend that the user commits the .gemini-local/ folder to track history. Make sure their .gitignore contains the following lines to exclude raw binaries and local sync state caches:
    .gemini-local/**/raw/
    .gemini-local/.sync_state.json
    
  2. Launch Viewer: After running a sync, always open the generated viewer to present the result to the user:
    open .gemini-local/viewer.html
    
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall