@tryarcanist/cli 0.1.268 → 0.1.270

package/README.md

@@ -1,6 +1,6 @@
 # Arcanist CLI
 
-Command-line interface for [Arcanist](https://www.tryarcanist.com): create coding agent sessions, follow their output, and manage access tokens from your terminal or automation.
+Command-line interface for [Arcanist](https://www.tryarcanist.com): run Anubis QA verifications, follow session output, and manage access tokens from your terminal or automation.
 
 ## Install
 
@@ -14,12 +14,12 @@ Requires Node.js 22 or newer.
 
 ```bash
 arcanist auth login                 # paste a token from Settings > CLI
-arcanist sessions create https://github.com/your-org/your-repo "fix the login bug"
+arcanist anubis https://github.com/your-org/your-repo/pull/123 --wait --json
 ```
 
 ```bash
-export ARCANIST_TOKEN=arc_...       # write-scoped for create/send/stop
-SESSION_ID=$(arcanist sessions create your-org/your-repo "add tests for the auth module" --json | jq -r .sessionId)
+export ARCANIST_TOKEN=arc_...       # write-scoped for anubis/stop
+SESSION_ID=$(arcanist anubis your-org/your-repo/pull/123 --json | jq -r .sessionId)
 arcanist sessions events "$SESSION_ID" --follow --json
 ```
 
@@ -102,7 +102,7 @@ With `--json`, successful command output is machine-readable and newline-termina
 ```
 
 `error.data` is omitted when there is no structured recovery data.
-Stable fields are `serverCode` for server-provided error codes and `sessionId`/`sessionUrl` when `sessions create` created the session but failed to enqueue the prompt.
+Stable fields are `serverCode` for server-provided error codes and `sessionId` when the server started a session before the request failed.
 
 Exit codes:
 
@@ -116,7 +116,7 @@ Exit codes:
 130 interrupted
 ```
 
-Mutation commands send an `Idempotency-Key` header. The CLI does not auto-retry mutation endpoints; retry explicitly with the same `--idempotency-key` when a request may have already reached the server. `--idempotency-key` is available on `sessions create`, `sessions send`, `tokens create`, and `sandbox build`. `tokens create` and `sandbox build` use auto-random keys by default, so only an explicit key makes cross-invocation retries safe.
+Mutation commands send an `Idempotency-Key` header. The CLI does not auto-retry mutation endpoints; retry explicitly with the same `--idempotency-key` when a request may have already reached the server. `--idempotency-key` is available on `tokens create` and `sandbox build`. Both use auto-random keys by default, so only an explicit key makes cross-invocation retries safe.
 
 ## Commands
 
@@ -177,60 +177,6 @@ Deactivates the selector and removes the stored Codex subscription auth for your
 arcanist codex logout
 ```
 
-### `arcanist sessions create <repo-url> [prompt]`
-
-Creates a new session and sends the initial prompt.
-
-```bash
-arcanist sessions create https://github.com/your-org/your-repo "fix the login bug"
-arcanist sessions create your-org/your-repo "continue this work" --start-branch wip/resume-me
-printf "add tests" | arcanist sessions create your-org/your-repo --prompt-stdin --json
-printf "add tests" | arcanist sessions create your-org/your-repo --prompt-stdin --wait
-arcanist sessions create your-org/your-repo - --model gpt-5.5
-arcanist sessions create your-org/your-repo "refactor auth" --reasoning-effort xhigh
-arcanist sessions create your-org/your-repo "use the saved login" --browser-identity identity-id
-arcanist sessions create your-org/your-repo "start signed out" --browser-identity none
-arcanist sessions create your-org/your-repo "fix release branch" --base-branch release/2026-06
-arcanist sessions create your-org/your-repo "review the trace" --uploaded-file trace.txt
-arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-key 1f0e6f1a-...
-```
-
-`--model` pins the model for the session; the CLI rejects an unknown model before any network call. Run `arcanist models list` for the selectable models. When `--model` is omitted the default is used. Claude models run on the Codex runtime and require the Anthropic provider credential configured in Settings.
-
-`--wait` blocks until the created prompt finishes, prints the resulting PR/branch line in human-readable mode when it is already available, and exits non-zero if the prompt finishes with `status: failed`, making it suitable for cron or other schedulers that alert on command failure. JSON mode waits quietly and prints the create payload after the prompt completes successfully. `--poll-interval <ms>` tunes the completion check frequency.
-
-Use `--browser-identity <id|none>` to attach a business browser identity to the session, or pass `none` to explicitly start without one. Access is authorized by the control plane when the session is created.
-
-Use `--base-branch <branch>` to target a non-default base branch. The CLI only validates that the branch value is non-empty; branch existence is checked later by the session runtime.
-
-Use `--start-branch <branch>` to resume an existing branch with its history instead of forking a fresh branch off base; the control plane verifies the branch exists on the remote and fails closed if it does not.
-
-Repeatable `--uploaded-file <path>` flags attach local UTF-8 text files to the prompt. Uploaded file names come from the local basename; directory components are not sent.
-
-Sessions always start from a fresh sandbox (the warm sandbox pool was removed).
-
-`--idempotency-key <uuid>` is for manually retrying a create request that may have reached the server.
-The CLI derives separate session and prompt idempotency keys from the provided value.
-
-JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, reasoningEffort?, baseBranch?, startBranch?, promptId?}`. With `--wait`, JSON mode also includes best-effort result fields when available: `prUrl?`, `publishedBranch?`, and `lastBranch?`.
-
-### `arcanist sessions send <session-id> [prompt]`
-
-Sends a follow-up message to an existing session.
-
-```bash
-arcanist sessions send abc123 "also update the tests"
-arcanist sessions send abc123 "use this failure log" --uploaded-file failure.log
-printf "summarize current status" | arcanist sessions send abc123 --prompt-stdin --json
-arcanist sessions send abc123 "retry-safe send" --idempotency-key 1f0e6f1a-...
-arcanist sessions send abc123 "also update the tests" --wait --poll-interval 1000 --json
-```
-
-Repeatable `--uploaded-file <path>` flags attach local UTF-8 text files to the follow-up prompt. `--idempotency-key <uuid>` is for manually retrying a send that may have reached the server. `--wait` blocks until the sent prompt finishes; use `--poll-interval <ms>` to tune completion polling.
-
-JSON mode returns `{sessionId, promptId?}`.
-With `--wait`, JSON mode also includes best-effort result fields when available: `prUrl?`, `publishedBranch?`, `lastBranch?`.
-
 ### `arcanist sessions stop <session-id>`
 
 Stops the active run for a session. Idempotent: if no sandbox is active, the server returns `already_stopped`.
@@ -416,33 +362,15 @@ Active runs are deduplicated server-side, so the idempotency-key option does not
 
 ## Automation recipes
 
-Run a prompt on a schedule and alert only when the prompt itself fails — `sessions create --wait` makes the exit code reflect the prompt outcome:
-
-```cron
-*/15 * * * * printf 'summarize new error-tracker regressions' | \
-  ARCANIST_TOKEN=arc_... \
-  arcanist sessions create your-org/your-repo --prompt-stdin --wait \
-  || notify-send "Arcanist scheduled run failed"
-```
-
 Chain commands with `--json` and `jq`:
 
 ```bash
-SESSION_ID=$(arcanist sessions create your-org/your-repo "audit dependency licenses" --json | jq -r .sessionId)
+SESSION_ID=$(arcanist anubis your-org/your-repo/pull/123 --json | jq -r .sessionId)
 arcanist sessions events "$SESSION_ID" --follow --json | jq -r 'select(.type == "assistant_message")'
 ```
 
 For cron, prefer `ARCANIST_TOKEN` or a logged-in `~/.arcanist/config.json` over passing `--token` on the command line.
 
-To capture the PR URL after a successful run, read the best-effort result fields from `create --wait --json`:
-
-```bash
-RESULT=$(arcanist sessions create your-org/your-repo "fix the flaky test" --wait --json)
-PR_URL=$(jq -r '.prUrl // empty' <<<"$RESULT")
-SESSION_ID=$(jq -r '.sessionId' <<<"$RESULT")
-[ -n "$PR_URL" ] || { echo "PR URL not ready for $SESSION_ID" >&2; exit 1; }
-```
-
 ## Troubleshooting
 
 - **401 on login verification**: token may be invalid or expired. Regenerate in **Settings > CLI**.