asana-cli-skill 1.2.0 → 1.3.0

package/README.md

@@ -189,7 +189,7 @@ Line 2"
 
 ### `asana-cli update <url-or-id>`
 
-Updates a task: `--name`, `--notes` (replace), `--append-notes` (add to the end), `--assignee` (`none` unassigns), `--due` (`none` clears), `--complete` or `--reopen`, and custom fields with `--field "Name=Value"` (repeatable). Enum options match by name ignoring case, accents and icons, so `--field "Priority=Urgent"` selects an option shown with a leading icon.
+Updates a task: `--name`, `--notes` (replace), `--append-notes` (add to the end), `--assignee` (`none` unassigns), `--due` (`none` clears), `--complete` or `--reopen`, custom fields with `--field "Name=Value"` (repeatable), and images shown inline at the end of the description with `--image <path>` (repeatable; the text is kept unless `--notes` replaces it). Enum options match by name ignoring case, accents and icons, so `--field "Priority=Urgent"` selects an option shown with a leading icon.
 
 ```bash
 asana-cli update 5678 --due 2026-10-31 --append-notes "Blocked by the vendor"

package/bin/asana-cli.js

@@ -189,6 +189,7 @@ program
     .option('--complete', 'Mark as completed (without a comment)')
     .option('--reopen', 'Mark as not completed')
     .option('--field <name=value>', 'Set a custom field, e.g. "Priority=High" (repeatable)', collectMultiple, [])
+    .option('--image <path>', 'Attach an image and show it inline at the end of the description (repeatable)', collectMultiple, [])
     .action(async (urlOrId, options) => {
         await updateCommand(urlOrId, options, getClient());
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asana-cli-skill",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Minimal CLI for Asana task management, built to power a Claude Code skill",
   "type": "module",
   "license": "MIT",
@@ -14,7 +14,7 @@
     "url": "https://github.com/giacomeli/asana-cli-skill/issues"
   },
   "bin": {
-    "asana-cli": "./bin/asana-cli.js"
+    "asana-cli": "bin/asana-cli.js"
   },
   "files": [
     "bin",

package/skills/asana/SKILL.md

@@ -144,7 +144,7 @@ Quick reference for `asana-cli`:
 | `asana-cli my-tasks` | Open tasks assigned to the user |
 | `asana-cli comments <url-or-id> [--last n]` | Read a task's comments |
 | `asana-cli create-task -n "name" -p <project> [-s section]` | Create a task |
-| `asana-cli update <id> [--name/--notes/--append-notes/--assignee/--due/--complete/--reopen/--field "Name=Value"]` | Update a task, including custom fields |
+| `asana-cli update <id> [--name/--notes/--append-notes/--assignee/--due/--complete/--reopen/--field "Name=Value"/--image <path>]` | Update a task, including custom fields and inline images in the description |
 | `asana-cli move <id> --after <sibling-id>` | Reorder subtasks or change the parent |
 | `asana-cli edit-comment <comment-id> -m "text"` | Fix a comment's text, keeping inline images |
 | `asana-cli delete-comment <comment-id>` | Delete a comment (ID from `comments`) |

package/src/commands/update.js

@@ -1,4 +1,6 @@
-import { parseTaskId, buildTaskFields, unescapeNewlines, parseFieldAssignments } from '../utils.js';
+import { existsSync } from 'fs';
+
+import { parseTaskId, buildTaskFields, unescapeNewlines, parseFieldAssignments, buildHtmlNotes } from '../utils.js';
 import { formatSuccess } from '../formatter.js';
 
 export async function updateCommand(urlOrId, options, client) {
@@ -11,6 +13,11 @@ export async function updateCommand(urlOrId, options, client) {
         throw new Error('Use either --complete or --reopen, not both');
     }
 
+    const images = options.image || [];
+    for (const filePath of images) {
+        if (!existsSync(filePath)) throw new Error(`File not found: ${filePath}`);
+    }
+
     const data = buildTaskFields(options);
 
     if (options.appendNotes !== undefined) {
@@ -23,8 +30,19 @@ export async function updateCommand(urlOrId, options, client) {
 
     const fields = parseFieldAssignments(options.field || []);
 
-    if (Object.keys(data).length === 0 && fields.length === 0) {
-        throw new Error('Nothing to update. Pass at least one of --name, --notes, --append-notes, --assignee, --due, --complete, --reopen, --field');
+    if (Object.keys(data).length === 0 && fields.length === 0 && images.length === 0) {
+        throw new Error('Nothing to update. Pass at least one of --name, --notes, --append-notes, --assignee, --due, --complete, --reopen, --field, --image');
+    }
+
+    // Images go inline after the description text, which is kept when --notes is not passed.
+    if (images.length > 0) {
+        const text = data.notes ?? (await client.getTask(taskId)).notes ?? '';
+        delete data.notes;
+        const gids = [];
+        for (const filePath of images) {
+            gids.push((await client.uploadAttachment(taskId, filePath)).gid);
+        }
+        data.html_notes = buildHtmlNotes(text, gids);
     }
 
     if (Object.keys(data).length > 0) {

package/src/utils.js

@@ -136,3 +136,13 @@ export function parseFieldAssignments(pairs) {
         return { name: pair.slice(0, index).trim(), value: pair.slice(index + 1).trim() };
     });
 }
+
+/**
+ * Builds a rich-text description: the plain text (escaped) followed by the task's own
+ * attachments shown inline. Asana only renders <img data-asana-gid> for attachments of the same task.
+ */
+export function buildHtmlNotes(text, imageGids) {
+    const escaped = text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    const images = imageGids.map((gid) => `<img data-asana-gid="${gid}"/>`).join('');
+    return `<body>${escaped ? `${escaped}\n` : ''}${images}</body>`;
+}