Ask
hlvm ask runs one-shot AI tasks from the shell. Use it for code review,
summaries, local file work, structured output, and automation.
Basic Use
hlvm ask "find TypeScript files in this repo that mention XMLHttpRequest"
By default, output is concise. Add --verbose when you need the agent header,
tool labels, stats, and trace events.
hlvm ask --verbose "review this package for obvious release blockers"
Permission Modes
| Mode | Use When |
|---|---|
readOnly | You want inspection only |
acceptEdits | You want file edits without repeated approval |
default | You want read actions automatic and writes confirmed |
plan | You want a plan gate before mutations |
bypassPermissions | You intentionally allow all actions |
Example:
hlvm ask --permission-mode readOnly "audit docs links and report failures"
Attach Files
hlvm ask --attach ./screenshot.png "explain the UI issue"
hlvm ask --attach ./report.pdf --attach ./data.csv "summarize and compare"
Structured Output
Use JSON modes for scripts:
hlvm ask --output-format json "count markdown files"
hlvm ask --output-format stream-json "summarize this repo"
stream-json emits newline-delimited events. json emits a single final result.
Models And Agents
hlvm ask --model claude-code/claude-sonnet-4-6 "review this PR"
hlvm ask --agent reviewer "review the current diff"
Use Models to set defaults and Agents to manage named agents.