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:
2026-02-20 16:41:19 -08:00
parent 0d35ac9ffd
commit f39a551aad
152 changed files with 21197 additions and 83 deletions

40
protonmail/CLAUDE.md Normal file
View 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.