loudmouth-ai 0.1.0 → 0.2.0

package/skills/gog/SKILL.md

@@ -1,92 +0,0 @@
----
-name: gog
-description: Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
-homepage: https://gogcli.sh
-metadata: {"clawdbot":{"emoji":"🎮","requires":{"bins":["gog"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gogcli","bins":["gog"],"label":"Install gog (brew)"}]}}
----
-
-# gog
-
-Use `gog` for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.
-
-Setup (once)
-- `gog auth credentials /path/to/client_secret.json`
-- `gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets`
-- `gog auth list`
-
-Common commands
-- Gmail search: `gog gmail search 'newer_than:7d' --max 10`
-- Gmail messages search (per email, ignores threading): `gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com`
-- Gmail send (plain): `gog gmail send --to a@b.com --subject "Hi" --body "Hello"`
-- Gmail send (multi-line): `gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt`
-- Gmail send (stdin): `gog gmail send --to a@b.com --subject "Hi" --body-file -`
-- Gmail send (HTML): `gog gmail send --to a@b.com --subject "Hi" --body-html "<p>Hello</p>"`
-- Gmail draft: `gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt`
-- Gmail send draft: `gog gmail drafts send <draftId>`
-- Gmail reply: `gog gmail send --to a@b.com --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>`
-- Calendar list events: `gog calendar events <calendarId> --from <iso> --to <iso>`
-- Calendar create event: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>`
-- Calendar create with color: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7`
-- Calendar update event: `gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4`
-- Calendar show colors: `gog calendar colors`
-- Drive search: `gog drive search "query" --max 10`
-- Contacts: `gog contacts list --max 20`
-- Sheets get: `gog sheets get <sheetId> "Tab!A1:D10" --json`
-- Sheets update: `gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED`
-- Sheets append: `gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS`
-- Sheets clear: `gog sheets clear <sheetId> "Tab!A2:Z"`
-- Sheets metadata: `gog sheets metadata <sheetId> --json`
-- Docs export: `gog docs export <docId> --format txt --out /tmp/doc.txt`
-- Docs cat: `gog docs cat <docId>`
-
-Calendar Colors
-- Use `gog calendar colors` to see all available event colors (IDs 1-11)
-- Add colors to events with `--event-color <id>` flag
-- Event color IDs (from `gog calendar colors` output):
-  - 1: #a4bdfc
-  - 2: #7ae7bf
-  - 3: #dbadff
-  - 4: #ff887c
-  - 5: #fbd75b
-  - 6: #ffb878
-  - 7: #46d6db
-  - 8: #e1e1e1
-  - 9: #5484ed
-  - 10: #51b749
-  - 11: #dc2127
-
-Email Formatting
-- Prefer plain text. Use `--body-file` for multi-paragraph messages (or `--body-file -` for stdin).
-- Same `--body-file` pattern works for drafts and replies.
-- `--body` does not unescape `\n`. If you need inline newlines, use a heredoc or `$'Line 1\n\nLine 2'`.
-- Use `--body-html` only when you need rich formatting.
-- HTML tags: `<p>` for paragraphs, `<br>` for line breaks, `<strong>` for bold, `<em>` for italic, `<a href="url">` for links, `<ul>`/`<li>` for lists.
-- Example (plain text via stdin):
-  ```bash
-  gog gmail send --to recipient@example.com \
-    --subject "Meeting Follow-up" \
-    --body-file - <<'EOF'
-  Hi Name,
-
-  Thanks for meeting today. Next steps:
-  - Item one
-  - Item two
-
-  Best regards,
-  Your Name
-  EOF
-  ```
-- Example (HTML list):
-  ```bash
-  gog gmail send --to recipient@example.com \
-    --subject "Meeting Follow-up" \
-    --body-html "<p>Hi Name,</p><p>Thanks for meeting today. Here are the next steps:</p><ul><li>Item one</li><li>Item two</li></ul><p>Best regards,<br>Your Name</p>"
-  ```
-
-Notes
-- Set `GOG_ACCOUNT=you@gmail.com` to avoid repeating `--account`.
-- For scripting, prefer `--json` plus `--no-input`.
-- Sheets values can be passed via `--values-json` (recommended) or as inline rows.
-- Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
-- Confirm before sending mail or creating events.
-- `gog gmail search` returns one row per thread; use `gog gmail messages search` when you need every individual email returned separately.

package/skills/goplaces/SKILL.md

@@ -1,30 +0,0 @@
----
-name: goplaces
-description: Query Google Places API (New) via the goplaces CLI for text search, place details, resolve, and reviews. Use for human-friendly place lookup or JSON output for scripts.
-homepage: https://github.com/steipete/goplaces
-metadata: {"clawdbot":{"emoji":"📍","requires":{"bins":["goplaces"],"env":["GOOGLE_PLACES_API_KEY"]},"primaryEnv":"GOOGLE_PLACES_API_KEY","install":[{"id":"brew","kind":"brew","formula":"steipete/tap/goplaces","bins":["goplaces"],"label":"Install goplaces (brew)"}]}}
----
-
-# goplaces
-
-Modern Google Places API (New) CLI. Human output by default, `--json` for scripts.
-
-Install
-- Homebrew: `brew install steipete/tap/goplaces`
-
-Config
-- `GOOGLE_PLACES_API_KEY` required.
-- Optional: `GOOGLE_PLACES_BASE_URL` for testing/proxying.
-
-Common commands
-- Search: `goplaces search "coffee" --open-now --min-rating 4 --limit 5`
-- Bias: `goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000`
-- Pagination: `goplaces search "pizza" --page-token "NEXT_PAGE_TOKEN"`
-- Resolve: `goplaces resolve "Soho, London" --limit 5`
-- Details: `goplaces details <place_id> --reviews`
-- JSON: `goplaces search "sushi" --json`
-
-Notes
-- `--no-color` or `NO_COLOR` disables ANSI color.
-- Price levels: 0..4 (free → very expensive).
-- Type filter sends only the first `--type` value (API accepts one).

package/skills/himalaya/SKILL.md

@@ -1,217 +0,0 @@
----
-name: himalaya
-description: "CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language)."
-homepage: https://github.com/pimalaya/himalaya
-metadata: {"clawdbot":{"emoji":"📧","requires":{"bins":["himalaya"]},"install":[{"id":"brew","kind":"brew","formula":"himalaya","bins":["himalaya"],"label":"Install Himalaya (brew)"}]}}
----
-
-# Himalaya Email CLI
-
-Himalaya is a CLI email client that lets you manage emails from the terminal using IMAP, SMTP, Notmuch, or Sendmail backends.
-
-## References
-
-- `references/configuration.md` (config file setup + IMAP/SMTP authentication)
-- `references/message-composition.md` (MML syntax for composing emails)
-
-## Prerequisites
-
-1. Himalaya CLI installed (`himalaya --version` to verify)
-2. A configuration file at `~/.config/himalaya/config.toml`
-3. IMAP/SMTP credentials configured (password stored securely)
-
-## Configuration Setup
-
-Run the interactive wizard to set up an account:
-```bash
-himalaya account configure
-```
-
-Or create `~/.config/himalaya/config.toml` manually:
-```toml
-[accounts.personal]
-email = "you@example.com"
-display-name = "Your Name"
-default = true
-
-backend.type = "imap"
-backend.host = "imap.example.com"
-backend.port = 993
-backend.encryption.type = "tls"
-backend.login = "you@example.com"
-backend.auth.type = "password"
-backend.auth.cmd = "pass show email/imap"  # or use keyring
-
-message.send.backend.type = "smtp"
-message.send.backend.host = "smtp.example.com"
-message.send.backend.port = 587
-message.send.backend.encryption.type = "start-tls"
-message.send.backend.login = "you@example.com"
-message.send.backend.auth.type = "password"
-message.send.backend.auth.cmd = "pass show email/smtp"
-```
-
-## Common Operations
-
-### List Folders
-
-```bash
-himalaya folder list
-```
-
-### List Emails
-
-List emails in INBOX (default):
-```bash
-himalaya envelope list
-```
-
-List emails in a specific folder:
-```bash
-himalaya envelope list --folder "Sent"
-```
-
-List with pagination:
-```bash
-himalaya envelope list --page 1 --page-size 20
-```
-
-### Search Emails
-
-```bash
-himalaya envelope list from john@example.com subject meeting
-```
-
-### Read an Email
-
-Read email by ID (shows plain text):
-```bash
-himalaya message read 42
-```
-
-Export raw MIME:
-```bash
-himalaya message export 42 --full
-```
-
-### Reply to an Email
-
-Interactive reply (opens $EDITOR):
-```bash
-himalaya message reply 42
-```
-
-Reply-all:
-```bash
-himalaya message reply 42 --all
-```
-
-### Forward an Email
-
-```bash
-himalaya message forward 42
-```
-
-### Write a New Email
-
-Interactive compose (opens $EDITOR):
-```bash
-himalaya message write
-```
-
-Send directly using template:
-```bash
-cat << 'EOF' | himalaya template send
-From: you@example.com
-To: recipient@example.com
-Subject: Test Message
-
-Hello from Himalaya!
-EOF
-```
-
-Or with headers flag:
-```bash
-himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message body here"
-```
-
-### Move/Copy Emails
-
-Move to folder:
-```bash
-himalaya message move 42 "Archive"
-```
-
-Copy to folder:
-```bash
-himalaya message copy 42 "Important"
-```
-
-### Delete an Email
-
-```bash
-himalaya message delete 42
-```
-
-### Manage Flags
-
-Add flag:
-```bash
-himalaya flag add 42 --flag seen
-```
-
-Remove flag:
-```bash
-himalaya flag remove 42 --flag seen
-```
-
-## Multiple Accounts
-
-List accounts:
-```bash
-himalaya account list
-```
-
-Use a specific account:
-```bash
-himalaya --account work envelope list
-```
-
-## Attachments
-
-Save attachments from a message:
-```bash
-himalaya attachment download 42
-```
-
-Save to specific directory:
-```bash
-himalaya attachment download 42 --dir ~/Downloads
-```
-
-## Output Formats
-
-Most commands support `--output` for structured output:
-```bash
-himalaya envelope list --output json
-himalaya envelope list --output plain
-```
-
-## Debugging
-
-Enable debug logging:
-```bash
-RUST_LOG=debug himalaya envelope list
-```
-
-Full trace with backtrace:
-```bash
-RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list
-```
-
-## Tips
-
-- Use `himalaya --help` or `himalaya <command> --help` for detailed usage.
-- 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.

package/skills/himalaya/references/configuration.md

@@ -1,174 +0,0 @@
-# Himalaya Configuration Reference
-
-Configuration file location: `~/.config/himalaya/config.toml`
-
-## Minimal IMAP + SMTP Setup
-
-```toml
-[accounts.default]
-email = "user@example.com"
-display-name = "Your Name"
-default = true
-
-# IMAP backend for reading emails
-backend.type = "imap"
-backend.host = "imap.example.com"
-backend.port = 993
-backend.encryption.type = "tls"
-backend.login = "user@example.com"
-backend.auth.type = "password"
-backend.auth.raw = "your-password"
-
-# SMTP backend for sending emails
-message.send.backend.type = "smtp"
-message.send.backend.host = "smtp.example.com"
-message.send.backend.port = 587
-message.send.backend.encryption.type = "start-tls"
-message.send.backend.login = "user@example.com"
-message.send.backend.auth.type = "password"
-message.send.backend.auth.raw = "your-password"
-```
-
-## Password Options
-
-### Raw password (testing only, not recommended)
-```toml
-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"
-```
-
-### System keyring (requires keyring feature)
-```toml
-backend.auth.keyring = "imap-example"
-```
-Then run `himalaya account configure <account>` to store the password.
-
-## Gmail Configuration
-
-```toml
-[accounts.gmail]
-email = "you@gmail.com"
-display-name = "Your Name"
-default = true
-
-backend.type = "imap"
-backend.host = "imap.gmail.com"
-backend.port = 993
-backend.encryption.type = "tls"
-backend.login = "you@gmail.com"
-backend.auth.type = "password"
-backend.auth.cmd = "pass show google/app-password"
-
-message.send.backend.type = "smtp"
-message.send.backend.host = "smtp.gmail.com"
-message.send.backend.port = 587
-message.send.backend.encryption.type = "start-tls"
-message.send.backend.login = "you@gmail.com"
-message.send.backend.auth.type = "password"
-message.send.backend.auth.cmd = "pass show google/app-password"
-```
-
-**Note:** Gmail requires an App Password if 2FA is enabled.
-
-## iCloud Configuration
-
-```toml
-[accounts.icloud]
-email = "you@icloud.com"
-display-name = "Your Name"
-
-backend.type = "imap"
-backend.host = "imap.mail.me.com"
-backend.port = 993
-backend.encryption.type = "tls"
-backend.login = "you@icloud.com"
-backend.auth.type = "password"
-backend.auth.cmd = "pass show icloud/app-password"
-
-message.send.backend.type = "smtp"
-message.send.backend.host = "smtp.mail.me.com"
-message.send.backend.port = 587
-message.send.backend.encryption.type = "start-tls"
-message.send.backend.login = "you@icloud.com"
-message.send.backend.auth.type = "password"
-message.send.backend.auth.cmd = "pass show icloud/app-password"
-```
-
-**Note:** Generate an app-specific password at appleid.apple.com
-
-## Folder Aliases
-
-Map custom folder names:
-```toml
-[accounts.default.folder.alias]
-inbox = "INBOX"
-sent = "Sent"
-drafts = "Drafts"
-trash = "Trash"
-```
-
-## Multiple Accounts
-
-```toml
-[accounts.personal]
-email = "personal@example.com"
-default = true
-# ... backend config ...
-
-[accounts.work]
-email = "work@company.com"
-# ... backend config ...
-```
-
-Switch accounts with `--account`:
-```bash
-himalaya --account work envelope list
-```
-
-## Notmuch Backend (local mail)
-
-```toml
-[accounts.local]
-email = "user@example.com"
-
-backend.type = "notmuch"
-backend.db-path = "~/.mail/.notmuch"
-```
-
-## OAuth2 Authentication (for providers that support it)
-
-```toml
-backend.auth.type = "oauth2"
-backend.auth.client-id = "your-client-id"
-backend.auth.client-secret.cmd = "pass show oauth/client-secret"
-backend.auth.access-token.cmd = "pass show oauth/access-token"
-backend.auth.refresh-token.cmd = "pass show oauth/refresh-token"
-backend.auth.auth-url = "https://provider.com/oauth/authorize"
-backend.auth.token-url = "https://provider.com/oauth/token"
-```
-
-## Additional Options
-
-### Signature
-```toml
-[accounts.default]
-signature = "Best regards,\nYour Name"
-signature-delim = "-- \n"
-```
-
-### Downloads directory
-```toml
-[accounts.default]
-downloads-dir = "~/Downloads/himalaya"
-```
-
-### Editor for composing
-Set via environment variable:
-```bash
-export EDITOR="vim"
-```

package/skills/himalaya/references/message-composition.md

@@ -1,182 +0,0 @@
-# Message Composition with MML (MIME Meta Language)
-
-Himalaya uses MML for composing emails. MML is a simple XML-based syntax that compiles to MIME messages.
-
-## Basic Message Structure
-
-An email message is a list of **headers** followed by a **body**, separated by a blank line:
-
-```
-From: sender@example.com
-To: recipient@example.com
-Subject: Hello World
-
-This is the message body.
-```
-
-## Headers
-
-Common headers:
-- `From`: Sender address
-- `To`: Primary recipient(s)
-- `Cc`: Carbon copy recipients
-- `Bcc`: Blind carbon copy recipients
-- `Subject`: Message subject
-- `Reply-To`: Address for replies (if different from From)
-- `In-Reply-To`: Message ID being replied to
-
-### Address Formats
-
-```
-To: user@example.com
-To: John Doe <john@example.com>
-To: "John Doe" <john@example.com>
-To: user1@example.com, user2@example.com, "Jane" <jane@example.com>
-```
-
-## Plain Text Body
-
-Simple plain text email:
-```
-From: alice@localhost
-To: bob@localhost
-Subject: Plain Text Example
-
-Hello, this is a plain text email.
-No special formatting needed.
-
-Best,
-Alice
-```
-
-## MML for Rich Emails
-
-### Multipart Messages
-
-Alternative text/html parts:
-```
-From: alice@localhost
-To: bob@localhost
-Subject: Multipart Example
-
-<#multipart type=alternative>
-This is the plain text version.
-<#part type=text/html>
-<html><body><h1>This is the HTML version</h1></body></html>
-<#/multipart>
-```
-
-### Attachments
-
-Attach a file:
-```
-From: alice@localhost
-To: bob@localhost
-Subject: With Attachment
-
-Here is the document you requested.
-
-<#part filename=/path/to/document.pdf><#/part>
-```
-
-Attachment with custom name:
-```
-<#part filename=/path/to/file.pdf name=report.pdf><#/part>
-```
-
-Multiple attachments:
-```
-<#part filename=/path/to/doc1.pdf><#/part>
-<#part filename=/path/to/doc2.pdf><#/part>
-```
-
-### Inline Images
-
-Embed an image inline:
-```
-From: alice@localhost
-To: bob@localhost
-Subject: Inline Image
-
-<#multipart type=related>
-<#part type=text/html>
-<html><body>
-<p>Check out this image:</p>
-<img src="cid:image1">
-</body></html>
-<#part disposition=inline id=image1 filename=/path/to/image.png><#/part>
-<#/multipart>
-```
-
-### Mixed Content (Text + Attachments)
-
-```
-From: alice@localhost
-To: bob@localhost
-Subject: Mixed Content
-
-<#multipart type=mixed>
-<#part type=text/plain>
-Please find the attached files.
-
-Best,
-Alice
-<#part filename=/path/to/file1.pdf><#/part>
-<#part filename=/path/to/file2.zip><#/part>
-<#/multipart>
-```
-
-## MML Tag Reference
-
-### `<#multipart>`
-Groups multiple parts together.
-- `type=alternative`: Different representations of same content
-- `type=mixed`: Independent parts (text + attachments)
-- `type=related`: Parts that reference each other (HTML + images)
-
-### `<#part>`
-Defines a message part.
-- `type=<mime-type>`: Content type (e.g., `text/html`, `application/pdf`)
-- `filename=<path>`: File to attach
-- `name=<name>`: Display name for attachment
-- `disposition=inline`: Display inline instead of as attachment
-- `id=<cid>`: Content ID for referencing in HTML
-
-## Composing from CLI
-
-### Interactive compose
-Opens your `$EDITOR`:
-```bash
-himalaya message write
-```
-
-### Reply (opens editor with quoted message)
-```bash
-himalaya message reply 42
-himalaya message reply 42 --all  # reply-all
-```
-
-### Forward
-```bash
-himalaya message forward 42
-```
-
-### Send from stdin
-```bash
-cat message.txt | himalaya template send
-```
-
-### Prefill headers from CLI
-```bash
-himalaya message write \
-  -H "To:recipient@example.com" \
-  -H "Subject:Quick Message" \
-  "Message body here"
-```
-
-## Tips
-
-- 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 `himalaya message export --full` to inspect the raw MIME structure of received emails.