ultrahope 0.1.2 → 0.1.4

package/README.md

@@ -19,6 +19,7 @@ ultrahope login
 ```
 
 This will display a URL and code. Open the URL in your browser, sign in, and enter the code to authorize the CLI.
+On first successful login, `${XDG_CONFIG_HOME:-~/.config}/ultrahope/config.toml` is created automatically if missing.
 
 ### Translate
 
@@ -33,6 +34,21 @@ git diff main | ultrahope translate --target pr-title-body
 
 # Analyze PR intent
 git diff main | ultrahope translate --target pr-intent
+
+# Override models for this run
+git diff --staged | ultrahope translate --target vcs-commit-message --models mistral/ministral-3b,xai/grok-code-fast-1
+```
+
+### Guide context for commit/message generation
+
+`git ultrahope commit` と `ultrahope jj describe` では `--guide <text>` を使って、差分だけでは分からない生成意図を補足できます。
+
+```bash
+# git commit の生成補足
+git add -A && git ultrahope commit --guide "GHSA-gq3j-xvxp-8hrf: override reason"
+
+# jj describe の生成補足
+jj ultrahope describe --guide "GHSA-gq3j-xvxp-8hrf: override reason"
 ```
 
 #### Targets
@@ -47,6 +63,21 @@ git diff main | ultrahope translate --target pr-intent
 
 - `ULTRAHOPE_API_URL` - API endpoint (default: `https://ultrahope.dev`)
 
+### Models Configuration
+
+Models are resolved in this order (highest priority first):
+
+1. CLI flag: `--models <model1,model2,...>`
+2. Project config: nearest `.ultrahope.toml` or `ultrahope.toml` in current/parent directories
+3. Global config: `${XDG_CONFIG_HOME:-~/.config}/ultrahope/config.toml`
+4. Built-in defaults
+
+Example config:
+
+```toml
+models = ["mistral/ministral-3b", "xai/grok-code-fast-1"]
+```
+
 ### Credentials
 
 Credentials are stored in `~/.config/ultrahope/credentials.json`.