SmartMail CLI Quick Reference

All commands run via python -m app.main <command> ... after pip install -r requirements.txt and a .env/env/.env.development with CLIENT_ID etc. set.

Auth

python -m app.main login
python -m app.main me

Inbox / folders

python -m app.main inbox --top 10
python -m app.main mail --folder Drafts --show-ids
python -m app.main folders --show-ids
python -m app.main create-folder TestFolder
python -m app.main move <draft_id> <folder_id>

Drafts / sending

python -m app.main create-draft --to "[email protected]" --subject "Test Draft" --body "This is a test draft message."
python -m app.main send --to [email protected] --subject "Hello from Graph" --body "It works."

AI operations (per message)

python -m app.main gpt-classify <mail_id>
python -m app.main gpt-summarise <mail_id>
python -m app.main gpt-extract <mail_id>
python -m app.main gpt-draft <mail_id>

Database

python -m app.main init-db

Running the app

python run.py                 # desktop entry point, serves on http://0.0.0.0:5001, opens /outlook

or install/run as a Windows service via service_wrapper.py (win32serviceutil).

Caveats

• Delete token_cache.bin in the project root to force a fresh interactive login.
• Never commit secrets; auth is OAuth/MSAL only, no hard-coded credentials.