Paul Payne
6d0332e32b
- 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.
41 lines
1.3 KiB
Markdown
41 lines
1.3 KiB
Markdown
# 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.
|