mo-tag

Prerequisites

CRITICAL — first read 共享规则, which contains mocli initialization, authentication, output parsing, and security rules

mocli tag - Mowen tags

This skill is used to read the tag list of 当前认证用户 . Currently it only supports getting my note tags, and will not create, delete, rename, or bind tags.

Command selection rules

When the user wants to "view my tags/get my tags/list my note tags/what tags do I have", use mocli tag mine。
When the user wants to "select X tags from existing tags, then tag/change tags for a note", first use mocli tag mine to get candidate tags, then combine with mo-note 's mocli note tag to complete the write.
When the user does not specify the tag type, handle it as note tags by default, i.e. use --filter note or omit --filter。
When the user wants to "add tags to a note/delete tags from a note/overwrite a note's tags", do not use this skill; instead use mo-note 's mocli note tag。
When the user wants to "view notes under one/some tags, filter notes by tag", do not use this skill; instead use mo-note 's mocli notes tagged; when needing to first select from existing tags, first use mocli tag mine to get the names and IDs of candidate tags.
When the user wants to "create an empty tag/rename a tag/delete the tag itself", explain that the current CLI does not yet support this capability, and do not use mocli tag mine to pretend to perform a write.

mocli tag mine [--filter]

This command is used to get the tag list of the current authenticated user. It is a read operation and will not modify any notes or tags.

Optional parameters:

--filter string: tag type. Currently only noteis supported, meaning my note tags; when not passed, the default is also note。

Usage principles

By default, just execute mocli tag mine when the filter condition needs to be expressed explicitly --filter note。
If the user passes in or requests a filter condition other than note , explain that currently only noteis supported, and do not try other values.
After execution, parse the top-level code、status、reasonaccording to the shared rules; on success display reply.tags, on failure display reason、msg、meta.hints and other actionable information.
If reply.tags is empty, clearly state that no tags are currently returned, and do not fabricate tag names.

Usage examples

View my tags mocli tag mine
View my note tags mocli tag mine --filter note

Select from existing tags and then tag a note

When the user wants to "select X tags from existing tags to tag a note", handle it according to the following process:

First execute mocli tag mine to get existing tag candidates.
Filter or display candidate tags according to the user's requirements; if the user only says "select X" but does not give filtering rules, first display the candidates and ask the user to confirm the specific tags, and do not choose on your own.
After the user confirms the tags, switch to mo-note to execute mocli note tag. When the user says "add/append these tags", use --append; when the user says "set the tags to these/keep only these", use --reset。
Before writing, you still need to follow the mo-note rules to confirm the target note ID, operation type, and final tag list.

Example workflow:

mocli tag mine
mocli note tag --note-id note-123 --append "AI,产品思考"

Output example

{
  "code": 0,
  "status": "OK",
  "reply": {
    "tags": [
      {
        "id": 11,
        "name": "AI"
      },
      {
        "id": 12,
        "name": "产品思考"
      }
    ]
  }
}

reply field description

Field	Type	Description
`tags`	array	The tag list of the currently authenticated user. Currently only note tags are returned.
`tags[].id`	integer	Tag ID, which can be used to precisely identify tags with the same name or for future API extensions.
`tags[].name`	string	Tag name, usually the main field displayed to the user.

Display suggestions

When there are few tags, display them one by one name, and you may include in parentheses id。
When there are many tags, use a concise list or table to display name and id。
When the user just wants to know "what tags there are," prioritize displaying tag names; unless the user needs scripted processing, do not let IDs take over the main display space.

Display rules

** Reference ** 公共展示规则