Files

Paul Payne f39a551aad 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.

2026-02-20 16:41:19 -08:00

1.3 KiB

Raw Blame History

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

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.

1.3 KiB Raw Blame History