@moxt-ai/cli 0.4.0-beta.1 → 0.4.0

package/README.md

@@ -137,6 +137,34 @@ moxt file search -w <workspace-id> --teammate-id <teammateId> <query>
 moxt file search -w <workspace-id> -l 50 --mode all <query>
 ```
 
+#### file comment
+
+Read and manage comments on a regular document. Identify the file by URL (`--url`) or by
+workspace + path (`-w` with `-p`, plus the usual space selectors). Creating and deleting
+comments is not supported from the CLI.
+
+```bash
+# List comment threads on a file (by URL)
+moxt file comment list --url <moxt-url>
+
+# List comment threads on a file (by path)
+moxt file comment list -w <workspace-id> -p <path>
+moxt file comment list -w <workspace-id> -s <teamspace-name> -p <path>
+
+# Update a comment you created (content read from a local UTF-8 text file)
+moxt file comment update --url <moxt-url> <comment-id> --content-path <local-path>
+moxt file comment update -w <workspace-id> -p <path> <comment-id> --content-path <local-path>
+
+# Resolve or reopen a comment thread
+moxt file comment resolve --url <moxt-url> <thread-id> --state resolved
+moxt file comment resolve --url <moxt-url> <thread-id> --state open
+```
+
+File comment content is read only from a local UTF-8 text file with `--content-path`.
+Inline `--content` is not supported. Only the comment author can
+`update` a comment; `resolve` only requires access to the file. Comment and thread IDs come
+from `file comment list`.
+
 ### memory
 
 Search archived agent memory (past chat conversations indexed for recall).
@@ -152,6 +180,64 @@ moxt memory search -w <workspace-id> --teammate-id <teammateId> <query>
 moxt memory search -w <workspace-id> -l 10 <query>
 ```
 
+### workflow
+
+Manage workflows, workflow definitions, tasks, and workflow agent runs.
+
+```bash
+# List workflows
+moxt workflow list -w <workspace-id>
+moxt workflow list -w <workspace-id> --scope owner_is_me
+
+# Create, inspect, update, duplicate, and delete workflows
+moxt workflow create -w <workspace-id> -p <path.workflow> [--desc-file <local-path>]
+moxt workflow get -w <workspace-id> <workflow-file-id>
+moxt workflow update -w <workspace-id> <workflow-file-id> --desc-file <local-path>
+moxt workflow duplicate -w <workspace-id> <workflow-file-id>
+moxt workflow delete -w <workspace-id> <workflow-file-id> [--message <message>]
+
+# Manage workflow statuses
+moxt workflow status create -w <workspace-id> <workflow-file-id> --name Todo --type 1
+moxt workflow status update -w <workspace-id> <workflow-file-id> <status-id> --type 2
+moxt workflow status move-after -w <workspace-id> <workflow-file-id> <status-id> --after <status-id>
+moxt workflow status move-after -w <workspace-id> <workflow-file-id> <status-id> --first
+moxt workflow status delete -w <workspace-id> <workflow-file-id> <status-id>
+
+# Manage workflow transitions
+moxt workflow transition create -w <workspace-id> <workflow-file-id> --from <status-id> --to <status-id>
+moxt workflow transition delete -w <workspace-id> <workflow-file-id> --from <status-id> --to <status-id>
+
+# Manage workflow tasks
+moxt workflow task list -w <workspace-id> [--workflow-file-id <workflow-file-id>]
+moxt workflow task get -w <workspace-id> <workflow-file-id> <task-id>
+moxt workflow task create -w <workspace-id> <workflow-file-id> --title "Review draft" --status <status-id>
+moxt workflow task update -w <workspace-id> <workflow-file-id> <task-id> --desc-file <local-path>
+moxt workflow task add-linked-files -w <workspace-id> <workflow-file-id> <task-id> --file-ids <file-id>[,<file-id>...]
+moxt workflow task remove-linked-files -w <workspace-id> <workflow-file-id> <task-id> --file-ids <file-id>[,<file-id>...]
+moxt workflow task move -w <workspace-id> <workflow-file-id> <task-id> --status <status-id>
+moxt workflow task assign -w <workspace-id> <workflow-file-id> <task-id> --human-id <human-id>
+moxt workflow task assign -w <workspace-id> <workflow-file-id> <task-id> --assistant-id <assistant-id>
+moxt workflow task assign -w <workspace-id> <workflow-file-id> <task-id> --teammate-id <teammate-id>
+moxt workflow task assign -w <workspace-id> <workflow-file-id> <task-id> --clear
+moxt workflow task delete -w <workspace-id> <workflow-file-id> <task-id>
+
+# Manage workflow task comments
+moxt workflow comment create -w <workspace-id> <workflow-file-id> <task-id> --content-path <local-path>
+moxt workflow comment list -w <workspace-id> <workflow-file-id> <task-id>
+moxt workflow comment delete -w <workspace-id> <workflow-file-id> <task-id> <comment-id>
+
+# Inspect or abort workflow agent runs
+moxt workflow run status -w <workspace-id> <workflow-file-id> <trigger-id> [trigger-id...]
+moxt workflow run output -w <workspace-id> <workflow-file-id> <trigger-id>
+moxt workflow run abort -w <workspace-id> <workflow-file-id> <trigger-id>
+```
+
+Workflow, status, and task descriptions are read from local UTF-8 text files with `--desc-file`.
+Inline `--desc` is not supported.
+Workflow task comment content is read only from a local UTF-8 text file with `--content-path` and is limited to
+5,000 characters. Inline `--content` is not supported.
+Workflow status type values are `1=todo`, `2=in-progress`, and `3=done`.
+
 #### File command options
 
 | Option | Description |