Skip to content

feat(chat-agent)!: add emptyState plugin option for the empty chat screen#138

Open
jhb-dev wants to merge 6 commits intomainfrom
claude/empty-chat-customization-api-gPoUw
Open

feat(chat-agent)!: add emptyState plugin option for the empty chat screen#138
jhb-dev wants to merge 6 commits intomainfrom
claude/empty-chat-customization-api-gPoUw

Conversation

@jhb-dev
Copy link
Copy Markdown
Contributor

@jhb-dev jhb-dev commented May 1, 2026

Summary

Replaces the hardcoded suggestedPrompts plugin option with a new emptyState configuration object that allows customization of the entire empty chat screen — including a custom title, markdown-rendered description, and starter prompt chips.

closes #136

…screen

Editors opening a fresh chat had no context for what the agent could or
couldn't do — they saw a generic headline and a few prompt chips and
discovered capabilities by trial and error. This adds an `emptyState`
option that exposes the empty screen as first-class plugin config:

- `title` overrides the default headline
- `description` is rendered as Markdown (same renderer as assistant
  messages), so links / lists / bold / inline code all work
- `suggestedPrompts` moves under `emptyState` and replaces (not merges
  with) the built-in defaults

BREAKING CHANGE: the previous top-level `suggestedPrompts` option has
moved to `emptyState.suggestedPrompts` — rename it in your
`chatAgentPlugin({ ... })` invocation to migrate.
@jhb-dev jhb-dev changed the title Add customizable empty state for chat screen feat(chat-agent)!: add emptyState plugin option for the empty chat screen May 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(chat-agent): add welcomeMessage or description option for empty chat state

2 participants