not-matthias/himalaya
modules/home/programs/cli-agents/shared/skills/cli-tools/himalaya/SKILL.md
Configure and use Himalaya CLI email client with Protonmail Bridge. Use when setting up himalaya, debugging IMAP/SMTP connection issues, or managing email from the terminal. Covers config format for v1.2.0, Protonmail Bridge quirks, and common commands.
$ install --global
skillsauthnpx skillsauth add not-matthias/dotfiles-nix himalayaInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 6:02 AM78.8s1 file scanned
SKILL.md
- name:
- himalaya
- description:
- Configure and use Himalaya CLI email client with Protonmail Bridge. Use when setting up himalaya, debugging IMAP/SMTP connection issues, or managing email from the terminal. Covers config format for v1.2.0, Protonmail Bridge quirks, and common commands.
Himalaya CLI Email
Rust-based CLI email client. Connects to Protonmail via Bridge's local IMAP/SMTP.
Config Location
~/.config/himalaya/config.toml
Protonmail Bridge Setup
Bridge exposes local IMAP/SMTP — credentials come from Bridge, not your Proton account.
Get credentials: protonmail-bridge --cli → login → info
- IMAP:
127.0.0.1:1143 - SMTP:
127.0.0.1:1025 - Login: your Proton email address
- Password: Bridge-generated token (NOT your account password)
Config Template (v1.2.0)
[accounts.proton]
default = true
email = "[email protected]"
display-name = "Your Name"
downloads-dir = "~/Downloads"
backend.type = "imap"
backend.host = "127.0.0.1"
backend.port = 1143
backend.encryption.type = "none"
backend.login = "[email protected]"
backend.auth.type = "password"
backend.auth.cmd = "pass show proton/bridge"
message.send.backend.type = "smtp"
message.send.backend.host = "127.0.0.1"
message.send.backend.port = 1025
message.send.backend.encryption.type = "none"
message.send.backend.login = "[email protected]"
message.send.backend.auth.type = "password"
message.send.backend.auth.cmd = "pass show proton/bridge"
Critical Config Gotchas
- Encryption MUST be
"none"— Bridge uses a self-signed cert that causesCaUsedAsEndEntityTLS errors with rustls. Localhost-only so no security risk. - Password key is
auth.cmdfor shell commands,auth.rawfor inline,auth.keyringfor system keyring. NOTauth.command— that's an invalid key. - Login is your full email even though Bridge generates a separate password.
Common Commands
himalaya envelope list # List inbox
himalaya envelope list -f Sent # List sent
himalaya message read <ID> # Read message
himalaya message write # Compose (opens $EDITOR)
himalaya message reply <ID> # Reply
himalaya message forward <ID> # Forward
himalaya attachment download <ID> # Download attachments
himalaya folder list # List folders
Debugging
himalaya envelope list --debug # Debug logs
himalaya envelope list --trace # Verbose trace + backtrace
Common errors:
CaUsedAsEndEntity→ Setencryption.type = "none"for both IMAP and SMTPcannot parse configuration→ Check for invalid keys (e.g.,auth.commandinstead ofauth.cmd)authentication failed→ Use Bridge password, not Proton account password- IMAP warning about continuation request → Harmless Bridge quirk, can ignore
Related Skills
not-matthias/personal-notes
documentation
VerifiedTrustedCommunity
Save notes, journal entries, and research to the personal-notes Obsidian vault (personal-vault-v2). Use when the user asks to 'save note', 'save to notes', 'write to personal notes', 'save to daily notes', 'note this down', or wants to persist findings/analysis to their personal vault.
9SKILL.mdUpdated Jul 29, 2026
not-matthias/fix-pr
documentation
VerifiedTrustedCommunity
Use whenever the user asks to address, fix, resolve, review, or respond to pull-request comments or review feedback.
9SKILL.mdUpdated Jul 29, 2026
not-matthias/code-style
development
VerifiedTrustedCommunity
Apply Not Matthias's Rust-first personal coding style. Use whenever the user explicitly asks to apply or review their code style, make Rust match their preferences, perform a style pass, or simplify/refactor according to their conventions. Inspect only task-touched code, honor local project conventions first, and make only safe opt-out style edits.
9SKILL.mdUpdated Jul 29, 2026
not-matthias/ast-grep
development
VerifiedTrustedCommunity
Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search codebases using Abstract Syntax Tree (AST) patterns, find specific code structures, or perform complex code queries that go beyond simple text search. This skill should be used when users ask to search for code patterns, find specific language constructs, or locate code with particular structural characteristics.
9SKILL.mdUpdated Jul 29, 2026