Skip to content

kofort9/ghostmail

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

👻 ghostmail — AI-Ready Email Context Blocks for Autonomous Agents

Python License Status Made With

ghostmail is a lightweight, modular email monitoring framework that extracts actionable context from your inbox and injects it directly into LLMs. It transforms structured email signals into agent-ready memory blocks — enabling smarter, more responsive autonomous workflows.

Overview

Ghostmail combines cyberpunk aesthetics with powerful email processing to create AI-ready context blocks. The framework features:

  • Structured email signal extraction
  • LLM-compatible memory block generation
  • Cyberpunk-themed command interface
  • Ghost animations and transitions
  • Rich text formatting and colors

Features

  • 🤖 AI-Ready Context Blocks
  • 🧠 LLM-Compatible Memory Format
  • 👻 Cyberpunk Ghost Interface
  • 🎨 Rich Text Formatting
  • 🚀 Fast and Lightweight

Project Evolution

The initial implementation focused on creating a cyberpunk-themed CLI interface with ghost animations. This served as a proof of concept for the visual and interactive aspects of the framework. As the project evolved, we refined the core functionality to focus on AI and autonomous agent integration, transforming email signals into structured context blocks that can be directly consumed by LLMs.

Installation

Ghostmail is currently only available through local development setup:

git clone https://github.com/yourusername/ghostmail.git
cd ghostmail
pip install -e .

Usage

Run the tool using:

ghostmail

Core Commands

  • recruiters? - Extract and structure job opportunity signals into AI-ready context blocks
  • statements? - Process financial statements into structured data for agent analysis
  • packages? - Transform delivery updates into actionable tracking events

Utility Commands

  • gh0st! - Display the command matrix with ghost animation
  • sp00ky! - Show a spooky ASCII art ghost
  • b00! - Display a boo message
  • gl1tch! - Show a glitch effect

Development

Ghostmail is built with:

  • click - For CLI implementation
  • rich - For rich text and cyberpunk aesthetic

License

MIT License

About

ghostmail: Modular email → LLM context injector. Inbox to agent memory.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages