Skip to main content
Sends a message to the QA.tech agent. The agent knows your test cases, applications, and configurations, and returns test case IDs you can pipe directly into qatech run. Useful for both scripting (single-shot) and exploration (interactive REPL).

​
Usage

# Single-shot
qatech chat [options] "<message>"

# Interactive REPL
qatech chat [options]

# From stdin
echo "<message>" | qatech chat
qatech chat --stdin <<'EOF'
<message>
EOF

​
Options

FlagShortDescription
--conversation <id>-cContinue an existing conversation (chat short ID)
--application-overrides <json>Override application target URLs as a JSON array
--json-jMachine-readable output (single-shot only)
--stdinForce reading the message from stdin even when stdin is a TTY
--api-key <key>Per-command API key override
--help-hShow command help

​
Modes

  • Single-shot - pass a message argument or pipe stdin. Streams the agent’s response, then exits.
  • Interactive - invoked with no message on a TTY. Drops you into a REPL; type exit or quit to leave.
  • Resume - pass -c <chat-short-id> to continue a previous conversation in either mode.

​
Examples

# Ask a question
qatech chat "What tests cover the checkout flow?"

# Pipe IDs into a run
ID=$(qatech chat --json "Most critical login test, just the ID" | jq -r '.content')
qatech run -c "$ID" --wait

# Continue a conversation
qatech chat -c chat_abc123 "Now run those tests"

# Interactive REPL
qatech chat

​
Testing against a custom URL

When you want the agent to test against a URL that isn’t a configured environment - e.g. a tunnel from qatech tunnel or a PR preview - pass --application-overrides: 
qatech chat --application-overrides '[{
  "applicationShortId": "app-myapp_Abc123",
  "environment": {"url": "https://preview.example.com"}
}]' "Test the login flow"
For multiple apps: 
qatech chat --application-overrides '[
  {"applicationShortId": "app-myapp_Abc123",  "environment": {"url": "https://web.preview.example.com"}},
  {"applicationShortId": "app-myapi_Def456", "environment": {"url": "https://api.preview.example.com"}}
]' "Run the full test suite"
The environment object accepts any of:
FormWhen to use
{"url": "..."}Inline URL override (tunnel, preview, etc.)
{"shortId": "env_xxx"}Reuse a saved environment
{"applicationBuildShortId": "bld_xxx"}Pin to a specific build
Application overrides apply to the first message of a conversation. When resuming with -c, the existing conversation already has its environment.

​
JSON output

{
  "conversationShortId": "chat_abc123",
  "messageId": "e5f6g7h8-...",
  "content": "Here are the tests covering checkout: ...",
  "url": "https://app.qa.tech/..."
}