docs: polish himalaya skill docs

This commit is contained in:
Peter Steinberger
2026-01-06 23:44:06 +01:00
parent 16243b7edc
commit ea216994a1
5 changed files with 14 additions and 15 deletions

View File

@@ -79,7 +79,7 @@ himalaya envelope list --page 1 --page-size 20
### Search Emails
```bash
himalaya envelope list --query "from:john@example.com subject:meeting"
himalaya envelope list --query "from john@example.com subject meeting"
```
### Read an Email
@@ -89,9 +89,9 @@ Read email by ID (shows plain text):
himalaya message read 42
```
Read as raw MIME:
Export raw MIME:
```bash
himalaya message read 42 --raw
himalaya message export 42 --full
```
### Reply to an Email
@@ -222,4 +222,3 @@ RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list
- Message IDs are relative to the current folder; re-list after folder changes.
- For composing rich emails with attachments, use MML syntax (see `references/message-composition.md`).
- Store passwords securely using `pass`, system keyring, or a command that outputs the password.

View File

@@ -39,14 +39,14 @@ backend.auth.raw = "your-password"
### Password from command (recommended)
```toml
backend.auth.cmd = "pass show email/imap"
backend.auth.cmd = "security find-generic-password -a user@example.com -s imap -w"
# backend.auth.cmd = "security find-generic-password -a user@example.com -s imap -w"
```
### System keyring (requires keyring feature)
```toml
backend.auth.keyring = "imap-example"
```
Then run `himalaya configure -a <account>` to store the password.
Then run `himalaya account configure <account>` to store the password.
## Gmail Configuration
@@ -172,4 +172,3 @@ Set via environment variable:
```bash
export EDITOR="vim"
```

View File

@@ -163,14 +163,15 @@ himalaya message forward 42
### Send from stdin
```bash
cat message.txt | himalaya message write
cat message.txt | himalaya template send
```
### Send with headers from CLI
### Prefill headers from CLI
```bash
echo "Message body here" | himalaya message write \
--to "recipient@example.com" \
--subject "Quick Message"
himalaya message write \
-H "To:recipient@example.com" \
-H "Subject:Quick Message" \
"Message body here"
```
## Tips
@@ -178,5 +179,4 @@ echo "Message body here" | himalaya message write \
- The editor opens with a template; fill in headers and body.
- Save and exit the editor to send; exit without saving to cancel.
- MML parts are compiled to proper MIME when sending.
- Use `--raw` with `message read` to see the raw MIME structure of received emails.
- Use `himalaya message export --full` to inspect the raw MIME structure of received emails.