@oxagen/cli 3.0.1-553 → 3.0.1-603

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.
Files changed (3) hide show
  1. package/README.md +33 -2
  2. package/oxagen.mjs +22473 -5046
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -171,8 +171,39 @@ needs no login. Its other flags are `--test-report`, `--runtime`,
171
171
  and `--fail-on-unconnected`. Each file flag takes `source=pattern` lines and
172
172
  can repeat. See https://docs.oxagen.sh/docs/cli/code-graph.
173
173
 
174
- These commands were `oxagen codegraph` before. The old name still runs each
175
- one and prints a line that names the new one.
174
+ Use `oxagen graph` in scripts and CI jobs. The `oxagen codegraph` command has been removed.
175
+
176
+ ## MCP tools
177
+
178
+ Use the MCP commands to list, inspect, and call the tools the server ships.
179
+ They use the token saved by `oxagen login`, or `OXAGEN_API_TOKEN` when set.
180
+ The server applies the token's workspace scope and permissions to each call.
181
+
182
+ ```sh
183
+ oxagen mcp list
184
+ oxagen mcp describe send_work_item
185
+ oxagen mcp call list_work_items --input '{}'
186
+ oxagen mcp call send_work_item --input-file work-input.json
187
+ cat work-input.json | oxagen mcp call send_work_item --input-file -
188
+ ```
189
+
190
+ Each command prints JSON. `list` follows every page and includes the tool
191
+ schemas. `describe` prints the complete descriptor for one tool. `call`
192
+ prints the complete MCP result, including content and structured output.
193
+ A tool refusal or a connection or protocol error exits with a nonzero code.
194
+ The server validates arguments against the tool's schema.
195
+
196
+ Input defaults to `{}` and must be a JSON object. Use `--input-file` for
197
+ sensitive input so it stays out of shell history and the process list.
198
+ `--input` and `--input-file` cannot be combined.
199
+
200
+ The default endpoint is `https://mcp.oxagen.sh/mcp`. Use `--endpoint <url>`
201
+ only for a trusted MCP server: the CLI sends your token to that address.
202
+ The URL must use HTTPS without credentials, query parameters, or a fragment.
203
+ The CLI refuses redirects. `--timeout-ms <ms>` sets the deadline for the
204
+ connection and request, including all catalogue pages. The default is 60000
205
+ milliseconds and the maximum is 600000 milliseconds. A timed-out call may
206
+ have reached the server; inspect the affected record before retrying a write.
176
207
 
177
208
  **Explain:** runs and audit
178
209