Skip to content

Cocoanetics/post-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Post Skill

OpenClaw skill for managing IMAP email with the Post CLI.

Documentation

Installation

Prerequisites

Install the Post CLI via Homebrew:

brew install cocoanetics/tap/post

Skill Installation

Via ClawHub:

clawhub install post

Or manually:

git clone https://github.com/Cocoanetics/post-skill.git ~/Developer/Skills/post

Quick Start

  1. Store credentials:

    post credential set --server work --host imap.example.com --port 993 --username you@example.com
  2. Start daemon:

    postd start
  3. Create scoped API key:

    post api-key create --servers work
  4. Use in agent:

    export POST_API_KEY=<token>
    post list --server work --mailbox INBOX --limit 10

See SETUP.md for complete setup instructions.

Features

  • ✅ Read, search, and fetch mail
  • ✅ Draft and reply with Markdown/HTML support
  • ✅ Reply-all with CC
  • ✅ Threaded replies (In-Reply-To, References)
  • ✅ Download attachments
  • ✅ Move, archive, trash, junk
  • ✅ Export as PDF/EML
  • ✅ IMAP IDLE daemon with hook support
  • ✅ Scoped API keys for per-agent access control

Changelog

1.5.0 (2026-03-17)

  • Unified reply workflow (post draft --replying-to <uid>)
  • Auto-derive from/to/subject when replying
  • --reply-all flag for reply-all with CC
  • Empty draft creation for inline editing
  • Auto-quote original message (HTML→Markdown)
  • Updated dependencies: SwiftText 1.1.4, SwiftMCP 1.4.0

Breaking Change: Removed post reply command — use post draft --replying-to <uid> instead

License

MIT

Related

About

OpenClaw skill for managing IMAP email with the Post CLI

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors