code-archaeology

Download Gmail programming attachments and organize them into date-based projects.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/hilash/CodeArchaeology --skill code-archaeology-hilash
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-archaeology
Source: https://github.com/hilash/CodeArchaeology/tree/main
Command: npx skills add https://github.com/hilash/CodeArchaeology --skill code-archaeology-hilash

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the discovery, organization, and local viewing of programming attachments stored in Gmail, turning scattered code assets into a browsable archive with per-project metadata and searchable summaries.

Core Features & Use Cases

  • Automatically scan Gmail for programming attachments and download them, organizing into date-based projects.
  • Generate per-project READMEs and a master catalog with language tagging, file previews, and searchable content.
  • Optional AI enrichment to produce concise summaries, clean titles, and topic tags to improve discovery.
  • Browse and run code locally in a retro Gmail-inspired web UI with syntax highlighting and a sandboxed runner.

Quick Start

Run the fetch command to scan your Gmail and build the local archive, then start the web viewer to browse your projects.

Frequently Asked Questions about code-archaeology

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract and organize code attachments from Gmail?

To extract and organize code attachments from Gmail, you can scan your inbox to automatically download programming files and group them into date-based projects. This builds a local archive with file previews and language tags.

Can I browse and view archived Gmail code projects locally?

You can browse and view archived Gmail code projects locally through a web UI with syntax highlighting. The interface provides a searchable catalog and a sandboxed runner for executing code directly in the browser.

How do I generate summaries and tags for downloaded code files?

You can generate summaries and tags for downloaded code files using optional AI enrichment. This feature produces concise project descriptions, clean titles, and topic tags to improve searchability within your local archive.

What is the best way to group scattered programming files into a searchable archive?

The best way to group scattered programming files into a searchable archive is to automate scanning email attachments, categorize them by date, and generate a master catalog with per-project READMEs and metadata.

Does the Gmail code viewer support running code in a sandbox?

The local web UI includes a sandboxed code viewer with optional run capability. This allows you to safely execute programming attachments directly from your browser after archiving them from Gmail.