@moxt-ai/cli 0.3.2 → 0.3.3-moxt-run.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -152,6 +152,36 @@ moxt memory search -w <workspace-id> --teammate-id <teammateId> <query>
152
152
  moxt memory search -w <workspace-id> -l 10 <query>
153
153
  ```
154
154
 
155
+ ### run
156
+
157
+ Run a local Codex or Claude Code process and capture the run as Moxt workspace context.
158
+
159
+ ```bash
160
+ # Local-only capture, no API key required
161
+ moxt run codex -- exec "summarize this repository"
162
+ moxt run claude -- -p "summarize this repository"
163
+
164
+ # Capture and upload source artifacts to the API key owner's personal space
165
+ moxt run -w <workspace-id> codex -- exec "summarize this repository"
166
+ moxt run -w <workspace-id> claude -- -p "summarize this repository"
167
+ ```
168
+
169
+ Uploaded files are stored by Moxt under `Local Agent Sessions/<run-id>/` in personal space. 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.
170
+
171
+ Local run artifacts are written under the platform user data directory by default:
172
+ 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`.
173
+
174
+ Real local-agent upload verification:
175
+
176
+ ```bash
177
+ MOXT_HOST=web-api.moxt.ws \
178
+ MOXT_API_KEY=moxt_... \
179
+ MOXT_WORKSPACE_ID=<workspace-id> \
180
+ pnpm --dir moxt-cli test:ai-e2e
181
+ ```
182
+
183
+ 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.
184
+
155
185
  #### File command options
156
186
 
157
187
  | Option | Description |
@@ -179,6 +209,8 @@ Set the following environment variables:
179
209
  |----------|-------------|
180
210
  | `MOXT_API_KEY` | Your Moxt API key |
181
211
  | `MOXT_HOST` | API hostname (default: `api.moxt.ai`) |
212
+ | `MOXT_CF_ACCESS_TOKEN` / `CF_ACCESS_TOKEN` | Optional Cloudflare Access token for protected development or testing hosts |
213
+ | `MOXT_CF_ACCESS_CLIENT_ID` / `MOXT_CF_ACCESS_CLIENT_SECRET` | Optional Cloudflare Access service-token credentials |
182
214
  | `MOXT_TELEMETRY_DISABLED` | Set to `1` to disable anonymous usage telemetry |
183
215
  | `DO_NOT_TRACK` | Set to `1` to disable anonymous usage telemetry (community standard) |
184
216