[Bug] cleo note ambiguity: agents confuse task notes with sticky notes

[kryptobaseddev]

Bug Report

When an agent runs cleo note T005 'some text', it routes to the cleo sticky subcommand instead of adding a note to task T005. The actual way to add task notes is cleo update T005 --notes 'text', but this is non-obvious.

Steps to reproduce:

1. Run cleo note T005 'some research findings'
2. Expect: note added to task T005
3. Actual: error from sticky note subsystem ('Unknown command T005')

Expected behavior: Either:

• cleo note <taskId> <text> should be a shorthand for cleo update <taskId> --notes <text>
• Or the error message should suggest the correct syntax

Impact: Medium — agents waste tokens discovering the correct syntax through trial and error. In my session I tried cleo note, cleo update --note, cleo update --add-note before finding cleo update --notes.

Severity: Moderate
Area: cli

Are you using an AI agent?

Yes - AI agent filed this issue

---

Environment

Component	Version
CLEO	2026.2.1
Node.js	v24.13.1
OS	linux 6.19.8-200.fc43.x86_64 x64 (x64)
Shell	/bin/bash
gh CLI	gh version 2.87.3 (2026-02-23)
Install	/home/keatonhoskins/.npm-global/bin/cleo