Skip to content

[DOCS] Document chat.suggestions next-step suggestion configuration #1005

Closed

Description

Summary

PR inference-gateway/cli#1554 adds an opt-in one-line next-step suggestion, rendered as dim ghost text in the empty chat input after an assistant turn completes. The CLI repo's own reference page was updated in the same PR, but the standalone docs site needs to cover the feature for users.

Affected pages

  • Configuration reference page for the chat section (mirrors inference-gateway/cli docs/configuration-reference.md)
  • Any page enumerating INFER_* environment overrides (new INFER_CHAT_SUGGESTIONS_* variables and the INFER_PROMPTS_CHAT_SUGGESTIONS_SYSTEM_PROMPT prompt override)
  • TUI feature overview wherever the input placeholder and history-suggestion behavior is described

Acceptance Criteria

  • Document chat.suggestions.enabled, chat.suggestions.model, chat.suggestions.context_messages, chat.suggestions.max_tokens and chat.suggestions.timeout, including defaults (false, empty falls back to agent.model, 4, 64, 10 seconds)
  • Document the Tab / Right Arrow accept-to-input behavior and the Esc, typing and new-turn dismissal
  • List the INFER_CHAT_SUGGESTIONS_* environment overrides next to the other chat overrides
  • Mention the silent-fail behavior and that the suggestion costs one extra small LLM call per completed turn
  • Use plain hyphens only, no en or em dashes

Activity

  1. added theissue type on Oct 12, 2026
  2. edenreich commented on Oct 12, 2026

    @edenreich
    Contributor

    @claude can you document this?

  3. inference-gateway-maintainer commented on Oct 12, 2026

    @inference-gateway-maintainer
    ContributorAuthor

    Claude finished @edenreich's task in 2m 31s —— View job • docs/issue-1005-20261012-1732


    Documented chat.suggestions

    • Gather context (upstream CLI docs/configuration-reference.md, local cli.md chat sections)
    • Document the chat.suggestions keys, defaults and env overrides
    • Document Tab / Right Arrow accept, Esc / typing / new-turn dismissal, silent-fail, one extra small LLM call per turn
    • Validate (lint:md, format:check, build all pass)
    • Commit and open PR

    All changes landed in cli.md:

    • New #### Next-Step Suggestions section under Chat Interface Features (right after the prompt-history search section): enabling it, the two-second quiet-window trigger, the cost note, a keybinding table for accept and dismissal, the silent-fail behavior, a YAML example and a key table with defaults.
    • INFER_CHAT_SUGGESTIONS_* plus INFER_PROMPTS_CHAT_SUGGESTIONS_SYSTEM_PROMPT added to the Essential Environment Variables block, and a one-line mention in the chat capabilities list.
    • Plain hyphens only, no en or em dashes.

    One deviation worth flagging: the issue lists max_tokens default as 64, but the CLI repo's current docs/configuration-reference.md says 512. I documented 512 as the canonical upstream value - tell me if the issue is the right one and I will flip it.

    Kept it to cli.md rather than touching configuration.md, whose chat section is generated from the gateway OpenAPI schema and does not carry CLI keys.

    Create a PR - already opened as #1006.
    · branch

  4. moved this from Todo to In progress in 2026on Oct 12, 2026
  5. moved this from In progress to QA in 2026on Oct 12, 2026
  6. inference-gateway-releaser commented on Oct 19, 2026

    @inference-gateway-releaser
    Contributor

    🎉 This issue has been resolved in version 0.9.22 🎉

    The release is available on GitHub release

    Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationreleased

    Type

    Projects

    • Status
      Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions