# --prompt-suggestions Flag

> It adds a guess at the next prompt to the stream.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude --prompt-suggestions, prompt_suggestion

## Think of it like

It is like a friend who guesses what you will ask next and says it for you.

## Definition

--prompt-suggestions adds a guess at your next prompt to the stream after each turn. The guess comes as a prompt_suggestion message. A very short chat may get none. It needs -p, --output-format stream-json and --verbose. An app can show the guess as a button the user taps.

## Example

Lucy's app shows one button under each reply. Its label comes from the prompt_suggestion message, so the user can go on with one tap.

## Example code

```bash
claude -p --prompt-suggestions --output-format stream-json --verbose "Explain this file"
```

Get a suggested next prompt after each turn.

## Why it matters

A good next step on a button saves the user from thinking of what to type.

## Common mistake

Expecting a guess every turn. Short chats may not get one, so the app has to work without it.

## Three principles

- **After each turn.** When there is one.
- **prompt_suggestion.** The message type.
- **Needs --verbose.** And stream-json.

## Related terms

- [--output-format Flag](https://learn.benibix.com/term/ai/output-format-flag)
- [--verbose Flag](https://learn.benibix.com/term/ai/verbose-flag)

## Taught in

- [Print Mode Output Flags](https://learn.benibix.com/learn/ai-claude-code-commands/print-mode-output-flags): Claude Code Commands, 14/17

---

Source: https://learn.benibix.com/term/ai/prompt-suggestions-flag
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
