@moxt-ai/cli 0.3.3-moxt-run.2 → 0.3.3

package/README.md

@@ -152,40 +152,63 @@ moxt memory search -w <workspace-id> --teammate-id <teammateId> <query>
 moxt memory search -w <workspace-id> -l 10 <query>
 ```
 
-### run
+### workflow
 
-Run a local Codex or Claude Code process and capture the run as Moxt workspace context.
+Manage workflows, workflow definitions, tasks, and workflow agent runs.
 
 ```bash
-# Local-only capture, no API key required
-moxt run codex -- exec "summarize this repository"
-moxt run claude -- -p "summarize this repository"
-
-# Capture and upload source artifacts to the API key owner's personal space
-moxt run -w <workspace-id> codex -- exec "summarize this repository"
-moxt run -w <workspace-id> claude -- -p "summarize this repository"
-
-# Or set a default workspace for repeated uploads
-export MOXT_WORKSPACE_ID=<workspace-id>
-moxt run codex -- exec "summarize this repository"
-moxt run claude -- -p "summarize this repository"
+# 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>
 ```
 
-Uploaded files are stored by Moxt under `Local Agent Sessions/<run-id>/` in personal space. For upload mode, `-w, --workspace` takes precedence over `MOXT_WORKSPACE_ID`; when neither is set, `moxt run` only writes the local capture artifact. While the local agent is running, Moxt periodically uploads changed artifact files and overwrites the same `run-id + artifact path` on the server. When the agent exits, Moxt performs one final flush. The command does not accept a workspace destination selector for run uploads; the server chooses the storage location. `moxt run` preserves the local agent's stdin/stdout/stderr behavior and returns the agent's exit code even when upload cleanup fails afterward.
-
-Local run artifacts are written under the platform user data directory by default:
-macOS `~/Library/Application Support/moxt/runs/<run-id>/`, Linux `${XDG_DATA_HOME:-~/.local/share}/moxt/runs/<run-id>/`, and Windows `%LOCALAPPDATA%\Moxt\runs\<run-id>`. For tests or local debugging, override with `MOXT_RUN_OUTPUT_ROOT` or `MOXT_RUN_OUTPUT_DIR`.
-
-Real local-agent upload verification:
-
-```bash
-MOXT_HOST=web-api.moxt.ws \
-MOXT_API_KEY=moxt_... \
-MOXT_WORKSPACE_ID=<workspace-id> \
-pnpm --dir moxt-cli test:ai-e2e
-```
-
-By default this starts both real `codex` and real `claude`. Set `MOXT_RUN_AI_E2E_AGENTS=codex` or `claude` to run only one. For `*.moxt.ws` hosts behind Cloudflare Access, the runner reads the local `cloudflared` `moxt.ws` token when present; alternatively set `MOXT_CF_ACCESS_TOKEN`, `CF_ACCESS_TOKEN`, or Cloudflare Access service-token env vars.
+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
 
@@ -213,12 +236,7 @@ Set the following environment variables:
 | Variable | Description |
 |----------|-------------|
 | `MOXT_API_KEY` | Your Moxt API key |
-| `MOXT_WORKSPACE_ID` | Default workspace ID for `moxt run` upload mode and AI E2E verification |
 | `MOXT_HOST` | API hostname (default: `api.moxt.ai`) |
-| `MOXT_RUN_UPLOAD_INTERVAL_MS` | Optional `moxt run` live-upload scan interval, default `5000`, minimum `250` |
-| `MOXT_RUN_UPLOAD_TIMEOUT_MS` | Optional `moxt run` per-file upload timeout, default `30000`, minimum `100` |
-| `MOXT_CF_ACCESS_TOKEN` / `CF_ACCESS_TOKEN` | Optional Cloudflare Access token for protected development or testing hosts |
-| `MOXT_CF_ACCESS_CLIENT_ID` / `MOXT_CF_ACCESS_CLIENT_SECRET` | Optional Cloudflare Access service-token credentials |
 | `MOXT_TELEMETRY_DISABLED` | Set to `1` to disable anonymous usage telemetry |
 | `DO_NOT_TRACK` | Set to `1` to disable anonymous usage telemetry (community standard) |