imap-agent-cli 0.1.2__tar.gz → 0.1.3__tar.gz

{imap_agent_cli-0.1.2 → imap_agent_cli-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imap-agent-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Agent-first IMAP CLI for safe email search, read, attachment download, and draft creation
 Project-URL: Homepage, https://github.com/pseudosavant/imap-agent-cli
 Project-URL: Repository, https://github.com/pseudosavant/imap-agent-cli
@@ -74,7 +74,7 @@ imap-agent-cli folders
 imap-agent-cli search --folder INBOX --subject "invoice" --max-results 10
 imap-agent-cli read --folder INBOX --uid 12345 --body-format html
 imap-agent-cli attachments --folder INBOX --uid 12345
-imap-agent-cli attachments download --folder INBOX --uid 12345 --part-id 2 --output-dir C:\tmp\email-attachments
+imap-agent-cli attachments download --folder INBOX --uid 12345 --part-id 2 --output-dir ./email-attachments
 imap-agent-cli draft create --to person@example.com --subject "Hello" --body "Draft only."
 imap-agent-cli draft reply --folder INBOX --uid 12345 --body "Thanks. I will review this."
 ```
@@ -104,9 +104,9 @@ Config path:
 
 Secrets should stay in environment variables, not the config file.
 
-## Codex Skill
+## Agent Skill
 
-Install or update the user-scoped Codex skill:
+Install or update the user-scoped `imap` skill:
 
 ```text
 imap-agent-cli install-skill
@@ -127,7 +127,7 @@ imap-agent-cli remove-skill
 Use `--skills-dir PATH` to install into a nonstandard skills directory, for example:
 
 ```text
-imap-agent-cli install-skill --skills-dir C:\Users\PaulEllis\.agents\skills
+imap-agent-cli install-skill --skills-dir ~/.agents/skills
 ```
 
 ## Safety Boundary

{imap_agent_cli-0.1.2 → imap_agent_cli-0.1.3}/README.md

@@ -41,7 +41,7 @@ imap-agent-cli folders
 imap-agent-cli search --folder INBOX --subject "invoice" --max-results 10
 imap-agent-cli read --folder INBOX --uid 12345 --body-format html
 imap-agent-cli attachments --folder INBOX --uid 12345
-imap-agent-cli attachments download --folder INBOX --uid 12345 --part-id 2 --output-dir C:\tmp\email-attachments
+imap-agent-cli attachments download --folder INBOX --uid 12345 --part-id 2 --output-dir ./email-attachments
 imap-agent-cli draft create --to person@example.com --subject "Hello" --body "Draft only."
 imap-agent-cli draft reply --folder INBOX --uid 12345 --body "Thanks. I will review this."
 ```
@@ -71,9 +71,9 @@ Config path:
 
 Secrets should stay in environment variables, not the config file.
 
-## Codex Skill
+## Agent Skill
 
-Install or update the user-scoped Codex skill:
+Install or update the user-scoped `imap` skill:
 
 ```text
 imap-agent-cli install-skill
@@ -94,7 +94,7 @@ imap-agent-cli remove-skill
 Use `--skills-dir PATH` to install into a nonstandard skills directory, for example:
 
 ```text
-imap-agent-cli install-skill --skills-dir C:\Users\PaulEllis\.agents\skills
+imap-agent-cli install-skill --skills-dir ~/.agents/skills
 ```
 
 ## Safety Boundary

{imap_agent_cli-0.1.2 → imap_agent_cli-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "imap-agent-cli"
-version = "0.1.2"
+version = "0.1.3"
 description = "Agent-first IMAP CLI for safe email search, read, attachment download, and draft creation"
 readme = "README.md"
 license = "MIT"

{imap_agent_cli-0.1.2 → imap_agent_cli-0.1.3}/src/imap_agent_cli/__init__.py

@@ -1,3 +1,3 @@
 """Agent-first IMAP CLI."""
 
-__version__ = "0.1.2"
+__version__ = "0.1.3"

{imap_agent_cli-0.1.2 → imap_agent_cli-0.1.3}/src/imap_agent_cli/skill.py

@@ -13,7 +13,7 @@ MANAGED_MARKER = "<!-- managed-by: imap-agent-cli -->"
 
 SKILL_MD = f"""---
 name: imap
-description: Use when the user asks Codex to search, read, summarize, inspect, or draft email using the local imap-agent-cli tool. Covers safe IMAP-only email access, folder enumeration, attachment download, and draft creation; must not send, delete, move, archive, flag, label, or mark messages read/unread.
+description: Use when the user asks an agentic tool to search, read, summarize, inspect, or draft email using imap-agent-cli. Covers safe IMAP-only email access, folder enumeration, attachment download, and draft creation; must not send, delete, move, archive, flag, label, or mark messages read/unread.
 ---
 
 {MANAGED_MARKER}
@@ -37,14 +37,13 @@ Use `imap-agent-cli` for safe agentic email workflows over IMAP. The tool can se
 
 Prefer the published CLI:
 
-```powershell
-$env:UV_LINK_MODE = "copy"
+```text
 uvx --refresh-package imap-agent-cli imap-agent-cli <command>
 ```
 
 If working inside the `imap-agent-cli` repository, this local form is also valid:
 
-```powershell
+```text
 uv run ./imap_agent_cli.py <command>
 ```
 
@@ -63,7 +62,7 @@ IMAP_AGENT_CLI_DRAFTS_FOLDER
 
 Use this to discover folder names and Drafts naming:
 
-```powershell
+```text
 uvx --refresh-package imap-agent-cli imap-agent-cli folders
 ```
 
@@ -73,7 +72,7 @@ Return only relevant folder names/counts to the user unless they ask for the ful
 
 Search defaults to `INBOX` when no folder is provided:
 
-```powershell
+```text
 uvx --refresh-package imap-agent-cli imap-agent-cli search --folder INBOX --max-results 10
 uvx --refresh-package imap-agent-cli imap-agent-cli search --folder INBOX --subject "invoice" --max-results 10
 uvx --refresh-package imap-agent-cli imap-agent-cli search --folder INBOX --from "Justin" --max-results 10
@@ -84,13 +83,13 @@ If a server-side `--from` search times out, enumerate recent messages with a bou
 
 For child folders:
 
-```powershell
+```text
 uvx --refresh-package imap-agent-cli imap-agent-cli search --folder Projects --recursive --max-results 25
 ```
 
 For all folders, use sparingly because large mailboxes can be slow:
 
-```powershell
+```text
 uvx --refresh-package imap-agent-cli imap-agent-cli search --all-folders --subject "contract" --max-results 25
 ```
 
@@ -98,7 +97,7 @@ uvx --refresh-package imap-agent-cli imap-agent-cli search --all-folders --subje
 
 Read a message by folder and UID from search results:
 
-```powershell
+```text
 uvx --refresh-package imap-agent-cli imap-agent-cli read --folder INBOX --uid 12345 --body-format metadata
 uvx --refresh-package imap-agent-cli imap-agent-cli read --folder INBOX --uid 12345 --body-format plain --max-body-chars 12000
 uvx --refresh-package imap-agent-cli imap-agent-cli read --folder INBOX --uid 12345 --body-format html
@@ -110,15 +109,15 @@ Use `metadata` first when confirming identity, attachments, or headers. Use `pla
 
 List attachment metadata:
 
-```powershell
+```text
 uvx --refresh-package imap-agent-cli imap-agent-cli attachments --folder INBOX --uid 12345
 ```
 
 Download requires an explicit output directory:
 
-```powershell
-uvx --refresh-package imap-agent-cli imap-agent-cli attachments download --folder INBOX --uid 12345 --part-id 1 --output-dir C:\\tmp\\email-attachments
-uvx --refresh-package imap-agent-cli imap-agent-cli attachments download --folder INBOX --uid 12345 --all --output-dir C:\\tmp\\email-attachments
+```text
+uvx --refresh-package imap-agent-cli imap-agent-cli attachments download --folder INBOX --uid 12345 --part-id 1 --output-dir ./email-attachments
+uvx --refresh-package imap-agent-cli imap-agent-cli attachments download --folder INBOX --uid 12345 --all --output-dir ./email-attachments
 ```
 
 Report saved paths to the user.
@@ -127,13 +126,13 @@ Report saved paths to the user.
 
 Create a new draft:
 
-```powershell
+```text
 uvx --refresh-package imap-agent-cli imap-agent-cli draft create --to person@example.com --subject "Subject" --body "Draft body"
 ```
 
 Create a reply draft from an existing message:
 
-```powershell
+```text
 uvx --refresh-package imap-agent-cli imap-agent-cli draft reply --folder INBOX --uid 12345 --body "Draft reply body"
 ```
 

{imap_agent_cli-0.1.2 → imap_agent_cli-0.1.3}/tests/test_skill.py

@@ -11,7 +11,7 @@ from tests import _bootstrap  # noqa: F401
 
 from imap_agent_cli.cli import main
 from imap_agent_cli.errors import AppError
-from imap_agent_cli.skill import MANAGED_MARKER, install_skill, remove_skill
+from imap_agent_cli.skill import MANAGED_MARKER, SKILL_MD, install_skill, remove_skill
 
 
 class SkillTests(unittest.TestCase):
@@ -32,6 +32,13 @@ class SkillTests(unittest.TestCase):
             self.assertTrue(second["installed"])
             self.assertFalse(second["updated"])
 
+    def test_skill_text_is_platform_and_agent_neutral(self) -> None:
+        self.assertIn("agentic tool", SKILL_MD)
+        self.assertNotIn("Codex", SKILL_MD)
+        self.assertNotIn("powershell", SKILL_MD.lower())
+        self.assertNotIn("UV_LINK_MODE", SKILL_MD)
+        self.assertNotIn("C:\\tmp", SKILL_MD)
+
     def test_remove_skill_removes_only_managed_skill(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)