patchcord 0.5.58 → 0.5.59

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "patchcord",
-  "version": "0.5.58",
+  "version": "0.5.59",
   "description": "Cross-machine agent messaging for Claude Code and Codex",
   "author": "ppravdin",
   "license": "MIT",

package/per-project-skills/codex/SKILL.md

@@ -95,33 +95,30 @@ To message a user outside your namespace, use `@username` as the to_agent. Examp
 
 ## File sharing
 
-Three modes:
-
-**Relay from URL (preferred for public files):**
+**Files on disk → `patchcord upload` (CLI, preferred):**
 ```
-attachment(relay=true, path_or_url="https://example.com/file.md", filename="file.md")
+patchcord upload /path/to/report.md --mime text/markdown
 ```
-Server fetches the URL and stores it. ~50 tokens instead of thousands for the file content.
+Prints the storage path. Pass it to `send_message`. No curl, no base64 in chat. 25MB cap.
 
-**Presigned upload (preferred for local files):**
+**Public URLs → `attachment(relay=true, ...)`:**
 ```
-attachment(upload=true, filename="report.md") -> returns {url, path}
-curl -X PUT -H "Content-Type: text/markdown" --data-binary @/path/to/report.md "<url>"
+attachment(relay=true, path_or_url="https://example.com/file.md", filename="file.md")
 ```
-Then send the `path` to the other agent. No base64, no token waste.
+Server fetches and stores. Use when the file already lives at a public URL.
 
-**Inline base64 (last resort — small generated content only):**
+**Inline base64 last resort:**
 ```
 attachment(upload=true, filename="notes.txt", file_data="<base64>")
 ```
-Base64 adds ~33% overhead and wastes context tokens. Never use this for files on disk — use presigned upload above instead.
+Only if you cannot run shell commands. Wastes context tokens.
 
 **Downloading:**
 ```
 attachment(path_or_url="namespace/agent/timestamp_file.md")
 ```
 
-Send the returned `path` to the other agent in your message so they can download it.
+Always send the storage path (not file content) to the other agent.
 
 ## Rules
 

package/skills/inbox/SKILL.md

@@ -83,34 +83,31 @@ To message a user outside your namespace, use `@username` as the to_agent. Examp
 
 ## File sharing
 
-Three modes, choose based on context:
-
-**Relay from URL (preferred for public files):**
+**Files on disk → `patchcord upload` (CLI, preferred):**
 ```
-attachment(relay=true, path_or_url="https://example.com/file.md", filename="file.md")
+patchcord upload /path/to/report.md --mime text/markdown
 ```
-Server fetches the URL and stores it. You send only a URL string (~50 tokens) instead of the file content (thousands of tokens). Always prefer relay when the file is at a public URL.
+Prints the storage path. Pass that path to `send_message`. No curl, no base64 in chat, no presigned URLs. 25MB cap.
 
-**Presigned upload (preferred for local files):**
+**Public URLs → `attachment(relay=true, ...)`:**
 ```
-attachment(upload=true, filename="report.md") -> returns {url, path}
-curl -X PUT -H "Content-Type: text/markdown" --data-binary @/path/to/report.md "<url>"
+attachment(relay=true, path_or_url="https://example.com/file.md", filename="file.md")
 ```
-Then send the `path` to the other agent. No base64, no token waste.
+Server fetches the URL and stores it. Use when the file already lives at a public URL.
 
-**Inline base64 (last resort — small generated content only):**
+**Web agents (no shell) → inline base64 last resort:**
 ```
 attachment(upload=true, filename="notes.txt", file_data="<base64>")
 ```
-Base64 adds ~33% overhead and wastes context tokens. Never use this for files on disk — use presigned upload above instead.
+Only for agents that cannot run shell commands. Wastes context tokens. Never use if you can run `patchcord upload`.
 
 **Downloading:**
 ```
 attachment(path_or_url="namespace/agent/timestamp_file.md")
 ```
-Use the path from the sender's message.
+Pass the storage path from the sender's message.
 
-Send the returned `path` to the other agent in your message so they can download it.
+Always send the storage path (not the file content) to the other agent.
 
 ## Identity (`patchcord whoami` / `patchcord agents`)