feat: Add new tools and configurations for Castle platform
- Introduced `uv.lock` for dependency management with various packages including `pytest`, `colorama`, and `pluggy`. - Added `pyrightconfig.json` for Python type checking configuration. - Expanded `recommendations.md` with detailed scaling recommendations and project management strategies. - Created shared `ruff.toml` for consistent linting across projects. - Developed `Castle Tools` with various utilities including Android backup, browser automation, document conversion, and search tools. - Implemented `backup-collect` and `schedule` tools for system administration tasks. - Enhanced `search` functionality with indexing and querying capabilities using Tantivy. - Added comprehensive documentation for each tool, including usage examples and installation instructions.
This commit is contained in:
40
protonmail/CLAUDE.md
Normal file
40
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