asana-cli-skill 1.1.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`.
+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"
@@ -207,6 +207,10 @@ asana-cli move 9013 --after 9012
 
 Deletes a comment. The ID is shown by `comments`. Only comments can be deleted, not system events.
 
+### `asana-cli edit-comment <comment-id> -m "text"`
+
+Replaces the text of a comment and keeps its inline images.
+
 ## Workspace
 
 `search`, `projects`, `my-tasks` and `create-task` need a workspace. They use, in order: `--workspace <id>`, the `ASANA_WORKSPACE` variable, or your only workspace (if you belong to several, the CLI lists them and asks for one).

package/bin/asana-cli.js

@@ -23,6 +23,7 @@ import { createTaskCommand } from '../src/commands/create-task.js';
 import { updateCommand } from '../src/commands/update.js';
 import { moveCommand } from '../src/commands/move.js';
 import { deleteCommentCommand } from '../src/commands/delete-comment.js';
+import { editCommentCommand } from '../src/commands/edit-comment.js';
 import { formatError } from '../src/formatter.js';
 
 // Load .env from the current directory first, then from ~/.asana-cli/
@@ -187,6 +188,8 @@ program
     .option('--due <date>', 'Due date (YYYY-MM-DD), or "none" to clear')
     .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());
     });
@@ -210,6 +213,15 @@ program
         await deleteCommentCommand(commentId, getClient());
     });
 
+program
+    .command('edit-comment')
+    .description('Replace the text of a comment, keeping its inline images')
+    .argument('<comment-id>', 'Comment ID')
+    .requiredOption('-m, --message <text>', 'New text')
+    .action(async (commentId, options) => {
+        await editCommentCommand(commentId, options, getClient());
+    });
+
 program.parseAsync().catch((err) => {
     console.error(formatError(err.message));
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asana-cli-skill",
-  "version": "1.1.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,8 +144,9 @@ 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]` | Update a task |
+| `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`) |
 | `asana-cli me` | Authenticated user and workspaces |
 

package/src/client.js

@@ -1,5 +1,7 @@
 import { basename } from 'path';
 
+import { normalizeLabel } from './utils.js';
+
 const BASE_URL = 'https://app.asana.com/api/1.0';
 
 export class AsanaClient {
@@ -79,7 +81,7 @@ export class AsanaClient {
 
     async getTask(taskId) {
         return this.request(
-            `/tasks/${taskId}?opt_fields=name,notes,completed,completed_at,due_on,created_at,permalink_url,parent.name,assignee.name,memberships.project.name,memberships.section.name,custom_fields.name,custom_fields.enum_value,custom_fields.enum_options,custom_fields.display_value`
+            `/tasks/${taskId}?opt_fields=name,notes,completed,completed_at,due_on,created_at,permalink_url,parent.name,assignee.name,memberships.project.name,memberships.section.name,custom_fields.name,custom_fields.resource_subtype,custom_fields.enum_value,custom_fields.enum_options,custom_fields.display_value`
         );
     }
 
@@ -189,7 +191,14 @@ export class AsanaClient {
     }
 
     async getStory(storyId) {
-        return this.request(`/stories/${storyId}?opt_fields=type,text,target.name,created_by.name`);
+        return this.request(`/stories/${storyId}?opt_fields=type,text,html_text,target.name,created_by.name`);
+    }
+
+    async updateStoryHtml(storyId, htmlText) {
+        return this.request(`/stories/${storyId}`, {
+            method: 'PUT',
+            body: JSON.stringify({ data: { html_text: htmlText } }),
+        });
     }
 
     async deleteStory(storyId) {
@@ -204,9 +213,16 @@ export class AsanaClient {
     }
 
     async setCustomFieldEnum(taskId, fieldName, optionName) {
+        return this.setCustomField(taskId, fieldName, optionName);
+    }
+
+    // Sets a custom field by name. Enum options match by name ignoring case, accents, spacing and
+    // decorations (an option shown as "[icon] Urgente" matches "urgente"); text and number fields
+    // take the value as is.
+    async setCustomField(taskId, fieldName, value) {
         const task = await this.getTask(taskId);
         const field = task.custom_fields?.find(
-            (f) => f.name.toLowerCase() === fieldName.toLowerCase()
+            (f) => normalizeLabel(f.name) === normalizeLabel(fieldName)
         );
         if (!field) {
             const available = task.custom_fields?.map((f) => f.name).join(', ') || 'none';
@@ -215,20 +231,31 @@ export class AsanaClient {
             );
         }
 
-        const option = field.enum_options?.find(
-            (o) => o.name.toLowerCase() === optionName.toLowerCase()
-        );
-        if (!option) {
-            const available = field.enum_options?.map((o) => o.name).join(', ') || 'none';
-            throw new Error(
-                `Option "${optionName}" not found in field "${fieldName}". Available options: ${available}`
+        let fieldValue;
+        if (field.resource_subtype === 'number') {
+            fieldValue = Number(value);
+            if (Number.isNaN(fieldValue)) {
+                throw new Error(`Field "${field.name}" is a number; got "${value}"`);
+            }
+        } else if (field.resource_subtype === 'text') {
+            fieldValue = value;
+        } else {
+            const option = field.enum_options?.find(
+                (o) => normalizeLabel(o.name) === normalizeLabel(value)
             );
+            if (!option) {
+                const available = field.enum_options?.map((o) => o.name).join(', ') || 'none';
+                throw new Error(
+                    `Option "${value}" not found in field "${field.name}". Available options: ${available}`
+                );
+            }
+            fieldValue = option.gid;
         }
 
         return this.request(`/tasks/${taskId}`, {
             method: 'PUT',
             body: JSON.stringify({
-                data: { custom_fields: { [field.gid]: option.gid } },
+                data: { custom_fields: { [field.gid]: fieldValue } },
             }),
         });
     }

package/src/commands/edit-comment.js

@@ -0,0 +1,29 @@
+import { unescapeNewlines } from '../utils.js';
+import { formatSuccess } from '../formatter.js';
+
+function escapeHtml(text) {
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+
+export async function editCommentCommand(commentId, options, client) {
+    if (!/^\d+$/.test(commentId)) {
+        throw new Error(`Invalid comment ID: ${commentId}`);
+    }
+    if (!options.message) {
+        throw new Error('--message is required');
+    }
+
+    const story = await client.getStory(commentId);
+    if (story.type !== 'comment') {
+        throw new Error(`Story ${commentId} is not a comment (type: ${story.type})`);
+    }
+
+    // Inline images live in the HTML as <img data-asana-gid="..."/>; keep them after the new text.
+    const images = (story.html_text || '').match(/<img [^>]*data-asana-gid="\d+"[^>]*\/?>/g) || [];
+    const text = escapeHtml(unescapeNewlines(options.message));
+    const html = `<body>${text}${images.length > 0 ? '\n' + images.join('\n') : ''}</body>`;
+
+    await client.updateStoryHtml(commentId, html);
+    const kept = images.length > 0 ? `\n   Inline images kept: ${images.length}` : '';
+    console.log(formatSuccess(`Comment edited on "${story.target?.name || '-'}"${kept}`));
+}

package/src/commands/update.js

@@ -1,4 +1,6 @@
-import { parseTaskId, buildTaskFields, unescapeNewlines } 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) {
@@ -21,11 +28,31 @@ export async function updateCommand(urlOrId, options, client) {
     if (options.complete) data.completed = true;
     if (options.reopen) data.completed = false;
 
-    if (Object.keys(data).length === 0) {
-        throw new Error('Nothing to update. Pass at least one of --name, --notes, --append-notes, --assignee, --due, --complete, --reopen');
+    const fields = parseFieldAssignments(options.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) {
+        await client.updateTask(taskId, data);
+    }
+    for (const { name, value } of fields) {
+        await client.setCustomField(taskId, name, value);
     }
 
-    await client.updateTask(taskId, data);
     const task = await client.getTask(taskId);
-    console.log(formatSuccess(`Task "${task.name}" updated: ${Object.keys(data).join(', ')}`));
+    const changed = [...Object.keys(data), ...fields.map((f) => f.name)];
+    console.log(formatSuccess(`Task "${task.name}" updated: ${changed.join(', ')}`));
 }

package/src/utils.js

@@ -110,3 +110,39 @@ export function buildTaskFields(options) {
 
     return data;
 }
+
+/**
+ * Normalizes a field or option label for matching: lowercase, no accents, and only letters,
+ * digits and single spaces (icons and punctuation around the label are ignored).
+ */
+export function normalizeLabel(label) {
+    return String(label)
+        .normalize('NFD')
+        .replace(/\p{Diacritic}/gu, '')
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, ' ')
+        .trim();
+}
+
+/**
+ * Parses "Name=Value" pairs from repeated --field options.
+ */
+export function parseFieldAssignments(pairs) {
+    return pairs.map((pair) => {
+        const index = pair.indexOf('=');
+        if (index <= 0 || index === pair.length - 1) {
+            throw new Error(`Invalid --field "${pair}": use "Field name=Value"`);
+        }
+        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>`;
+}