# Send Sog to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "sogcli", "name": "Sog", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/visionik/sogcli", "canonicalUrl": "https://clawhub.ai/visionik/sogcli", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/sogcli", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sogcli", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "CHANGELOG.md", "README.md", "SKILL.md", "Taskfile.yml", "cmd/sog/main.go", "internal/caldav/client.go" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "sogcli", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-09T06:17:45.009Z", "expiresAt": "2026-05-16T06:17:45.009Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sogcli", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sogcli", "contentDisposition": "attachment; filename=\"sogcli-0.3.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "sogcli" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/sogcli" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/sogcli", "downloadUrl": "https://openagent3.xyz/downloads/sogcli", "agentUrl": "https://openagent3.xyz/skills/sogcli/agent", "manifestUrl": "https://openagent3.xyz/skills/sogcli/agent.json", "briefUrl": "https://openagent3.xyz/skills/sogcli/agent.md" } } ``` ## Documentation ### sog — Standards Ops Gadget CLI for IMAP/SMTP/CalDAV/CardDAV/WebDAV. Open-standards alternative to gog (Google) and mog (Microsoft). ### Quick Start sog auth add you@fastmail.com --discover sog auth test sog mail list ### Global Flags --account, -a Account email to use ($SOG_ACCOUNT) --json JSON output (for scripting) --plain TSV output (parseable) --force Skip confirmations --no-input Never prompt (CI mode) --verbose, -v Debug logging --ai-help Detailed help text ### Authentication sog auth add [flags] --discover Auto-discover servers from DNS --imap-host IMAP server hostname --imap-port IMAP port (default: 993) --smtp-host SMTP server hostname --smtp-port SMTP port (default: 587) --caldav-url CalDAV server URL --carddav-url CardDAV server URL --webdav-url WebDAV server URL --password Password (stored in keychain) sog auth list # List accounts sog auth test [email] # Test connection sog auth remove # Remove account sog auth password # Set protocol-specific passwords --imap, --smtp, --caldav, --carddav, --webdav ### Mail (IMAP/SMTP) sog mail list [folder] --max N Maximum messages (default: 20) --unseen Only unread messages sog mail get --headers Headers only --raw Raw RFC822 format sog mail search # IMAP SEARCH syntax: FROM, TO, SUBJECT, SINCE, BEFORE, etc. # Example: sog mail search "FROM john SINCE 1-Jan-2026" sog mail send --to --subject [flags] --to Recipient(s) --cc CC recipient(s) --bcc BCC recipient(s) --subject Subject line --body Message body --body-file Read body from file (- for stdin) --body-html HTML body content sog mail reply --body sog mail forward --to sog mail move sog mail copy sog mail flag # Flags: seen, flagged, answered, deleted sog mail unflag sog mail delete ### Folders sog folders list sog folders create sog folders delete sog folders rename ### Drafts sog drafts list sog drafts create [flags] # Same flags as mail send sog drafts send sog drafts delete ### Calendar (CalDAV) sog cal list [calendar] --from Start date (default: today) --to End date (default: +30d) --max Maximum events sog cal get sog cal search # Search in title/description/location sog cal today [calendar] sog cal week [calendar] sog cal create --start <datetime> [flags] --start Start time (YYYY-MM-DDTHH:MM or YYYY-MM-DD for all-day) --end End time --duration Duration (1h, 30m) --location Location --description Description sog cal update <uid> [flags] # Same flags as create sog cal delete <uid> sog cal calendars # List calendars ### Contacts (CardDAV) sog contacts list [address-book] --max Maximum contacts sog contacts get <uid> sog contacts search <query> # Search name/email/phone sog contacts create <name> [flags] -e, --email Email address(es) -p, --phone Phone number(s) --org Organization --title Job title --note Note sog contacts update <uid> [flags] # Same flags as create sog contacts delete <uid> sog contacts books # List address books ### Tasks (CalDAV VTODO) sog tasks list [list] --all Include completed tasks sog tasks add <title> [flags] --due Due date (YYYY-MM-DD) -p, --priority Priority (1-9, 1=highest) -d, --description Description sog tasks get <uid> sog tasks update <uid> [flags] # Same flags as add sog tasks done <uid> # Mark complete sog tasks undo <uid> # Mark incomplete sog tasks delete <uid> sog tasks clear # Delete all completed tasks sog tasks due <date> # Tasks due by date sog tasks overdue # Overdue tasks sog tasks lists # List task lists ### Files (WebDAV) sog drive ls [path] -l Long format with details --all Show hidden files sog drive get <path> # Get file metadata sog drive download <remote> [local] sog drive upload <local> [remote] sog drive mkdir <path> sog drive delete <path> sog drive move <src> <dst> sog drive copy <src> <dst> sog drive cat <path> # Output file to stdout ### Meeting Invites (iTIP/iMIP) sog invite send <summary> <attendees>... --start <datetime> [flags] --start Start time --duration Duration (default: 1h) --location Location --description Description sog invite reply <file> --status <accept|decline|tentative> --comment Optional comment sog invite cancel <uid> <attendees>... sog invite parse <file> # Parse .ics file sog invite preview <summary> <attendees>... --start <datetime> ### IMAP IDLE sog idle [folder] # Watch for new mail (push notifications) --timeout Timeout in seconds ### Output Formats Default: Human-readable colored output --json: One JSON object per line (JSONL) --plain: Tab-separated values (TSV) ### Examples # List recent emails sog mail list --max 10 # Send an email sog mail send --to user@example.com --subject "Hello" --body "Hi there" sog mail send --to user@example.com --subject "Report" --body-file report.md cat draft.txt | sog mail send --to user@example.com --subject "Hi" --body-file - # Today's calendar sog cal today # Create a meeting with invite sog invite send "Team Sync" alice@example.com bob@example.com \\ --start "2026-01-25T14:00" --duration 30m --location "Zoom" # Add a task sog tasks add "Review PR" --due 2026-01-26 -p 1 # Upload a file sog drive upload report.pdf /documents/ # Search contacts sog contacts search "John" ### Tested Providers Fastmail ✅ (full support) Other standards-compliant providers should work but have not been tested yet. ### Credential Storage Passwords are stored securely in the native system credential store: PlatformBackendmacOSKeychainWindowsWindows Credential ManagerLinux/BSDD-Bus Secret Service (GNOME Keyring, KWallet) Supports separate passwords per protocol (IMAP, SMTP, CalDAV, CardDAV, WebDAV). ### Notes Set SOG_ACCOUNT=you@example.com to avoid repeating --account Part of the Ops Gadget family: gog (Google), mog (Microsoft), sog (Standards) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: visionik - Version: 0.3.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-09T06:17:45.009Z - Expires at: 2026-05-16T06:17:45.009Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/sogcli) - [Send to Agent page](https://openagent3.xyz/skills/sogcli/agent) - [JSON manifest](https://openagent3.xyz/skills/sogcli/agent.json) - [Markdown brief](https://openagent3.xyz/skills/sogcli/agent.md) - [Download page](https://openagent3.xyz/downloads/sogcli)