> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# agent-cards engineer ask

> Ask the AgentCard engineer a question and BLOCK for the answer (for coding

Ask the AgentCard engineer a question and BLOCK for the answer (for coding

```bash theme={null}
agent-cards engineer ask --help
```

```text theme={null}
Usage: agent-cards engineer ask [options]

Ask the AgentCard engineer a question and BLOCK for the answer (for coding
agents)

Options:
  --repo <path>          Repo root (default: current directory)
  --question <text>      The question to ask
  --snippet <path...>    File(s) to attach as code snippets (each capped at
                         8000 chars)
  --timeout <seconds>    Seconds to wait for the answer (default 480)
  --resume <questionId>  Keep waiting on a previously asked question instead of
                         asking a new one
  --json                 Machine-readable output (one JSON line on stdout)
  -h, --help             display help for command

For AI agents: run with a generous shell timeout (the command blocks up to
--timeout seconds). A timeout exits 0 with {"ok":false,"timedOut":true,
"questionId":"env_…"} — proceed with your best judgment and optionally re-run
with --resume <questionId> later; the answer also arrives in the shared Slack
channel. Requires the daemon (agent-cards engineer connect) to be running.
Never include secrets (API keys, tokens, client secrets) in a question.
```