Metadata-Version: 2.4
Name: llm-email
Version: 0.1.7
Summary: Send emails via macOS Mail.app — compose, draft, send with AppleScript
Project-URL: Homepage, https://cmdop.com/skills/llm-email/
Author-email: CMDOP Team <team@cmdop.com>
License-Expression: MIT
Keywords: applescript,cmdop,email,llm,macos,mail-app
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Email
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: pandas>=2.2.0
Requires-Dist: streamlit>=1.40.0
Requires-Dist: tortoise-orm>=0.21.0
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: interactive
Requires-Dist: click>=8.3.0; extra == 'interactive'
Description-Content-Type: text/markdown

# llm-email

> **[CMDOP Skill](https://cmdop.com/skills/llm-email/)** — install and use via [CMDOP agent](https://cmdop.com):
> ```
> cmdop-skill install llm-email
> ```
Send emails via macOS Mail.app — compose, draft, send with AppleScript.

## Install

```bash
pip install llm-email
```

## Quick Start

```python
from llm_email import send_email, init_db, close_db

await init_db()
result = await send_email(
    to="user@example.com",
    subject="Hello",
    body="Message body",
)
print(result)  # {"ok": True, "action": "send", ...}
await close_db()
```

## CLI

```bash
python run.py send --to "a@b.com" --subject "Hello" --body "Message"
python run.py draft --to "a@b.com" --subject "Hello" --body "Message"
python run.py accounts
python run.py health
python run.py status
python run.py stats
```

All commands output JSON. Parse the `ok` field to check success.

## Dashboard

```bash
email-dashboard
```

## API

```python
from llm_email import (
    send_email,      # send or draft an email
    list_accounts,   # list Mail.app accounts
    check_health,    # check if Mail.app is running
    show_status,     # recent sent email log
    show_stats,      # extended statistics
    check_duplicate, # deduplication check
)
```

## License

MIT
