feat: Add various tools for document processing and management
- Introduced `docx-extractor` for extracting content and metadata from Word .docx files. - Added `docx2md` for converting Word .docx files to Markdown format. - Implemented `gpt` for generating text using OpenAI's GPT models. - Created `html2text` for converting HTML content to plain text. - Developed `mbox2eml` for converting MBOX mailbox files to individual .eml files. - Added `md2pdf` for converting Markdown files to PDF format. - Introduced `mdscraper` for combining text files into a single markdown document. - Created `pdf-extractor` for extracting content and metadata from PDF files. - Developed `pdf2md` for converting PDF files to Markdown format. - Implemented `protonmail` for managing ProtonMail emails via Bridge. - Added `schedule` for managing systemd timers and services. - Introduced `search` for managing searchable collections of files. - Added `text-extractor` for extracting content and metadata from text files. - Removed outdated recommendations document.
This commit is contained in:
40
components/protonmail/CLAUDE.md
Normal file
40
components/protonmail/CLAUDE.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# CLAUDE.md
|
||||
|
||||
This file provides guidance to Claude Code (claude.ai/code) when working
|
||||
with code in this repository.
|
||||
|
||||
## Overview
|
||||
|
||||
protonmail is a CLI tool for accessing and managing ProtonMail emails via Bridge.
|
||||
All commands work with local cached .eml files for fast, offline access.
|
||||
|
||||
## Commands
|
||||
|
||||
```bash
|
||||
uv sync # Install dependencies
|
||||
uv run protonmail --version # Show version
|
||||
uv run protonmail sync # Sync emails from Bridge
|
||||
uv run protonmail list # List cached emails
|
||||
uv run protonmail read <file> # Read a specific email
|
||||
uv run protonmail search <query> # Search by subject/sender
|
||||
uv run pytest tests/ -v # Run tests
|
||||
uv run ruff check . # Lint
|
||||
uv run ruff format . # Format
|
||||
```
|
||||
|
||||
## Architecture
|
||||
|
||||
- `src/protonmail/main.py` — CLI entry point, all email operations
|
||||
- `src/protonmail/__init__.py` — Package version (`__version__`)
|
||||
- `tests/` — pytest tests
|
||||
|
||||
## Configuration
|
||||
|
||||
Environment variables (set by castle or manually):
|
||||
- `PROTONMAIL_USERNAME` — ProtonMail Bridge username
|
||||
- `PROTONMAIL_API_KEY` — ProtonMail Bridge API key
|
||||
- `PROTONMAIL_DATA_DIR` — Where to store synced .eml files (default: /data/messages/email/protonmail)
|
||||
|
||||
## Dependencies
|
||||
|
||||
stdlib-only — no third-party packages required.
|
||||
Reference in New Issue
Block a user