[DOCS] Document infer chat --session-id resume flag

[edenreich]

Summary

inference-gateway/cli#760 adds a --session-id flag to infer chat for resuming persisted chat sessions from the command line, and updates the exit message to print a copy-pasteable continuation command (infer chat --session-id <id>).

Behavior to document:

• infer chat --session-id <id> loads the persisted conversation before the TUI starts (requires a storage backend; see storage.enabled).
• Non-UUID values are treated as session group keys and resolve through the session rollover chain to the latest session.
• If the session cannot be loaded, the CLI prints a visible notice and starts a new session under the requested ID (same semantics as infer agent --session-id).
• The flag is ignored (with a printed notice) in --web and non-interactive (piped) modes.
• Session IDs can be discovered with infer conversations list.

Affected pages: the CLI chat command reference (wherever infer chat flags are documented), plus a cross-link from the infer agent --session-id docs.

Example to add:

infer conversations list          # Find session IDs
infer chat --session-id abc-123-def

Source: inference-gateway/cli#760

Acceptance Criteria

• infer chat --session-id documented on the chat command page with the resume example
• Fallback semantics (adopt requested ID when not found; storage requirement) documented
• Cross-link between infer chat --session-id and infer agent --session-id docs

[edenreich]

@infer Can you work on this?

[inference-gateway-maintainer]

Model: ollama_cloud/deepseek-v4-flash · View Job

Todos

• Explore repository structure to find relevant docs
• Find infer chat command reference page
• Find infer agent --session-id docs for cross-linking
• Document infer chat --session-id flag with resume example
• Document fallback semantics and storage requirement
• Add cross-link between chat and agent session-id docs
• Commit and push changes

Pull Request

#351

✅ Infer Result: Success

All done! Here's a summary of the changes made to resolve issue #349:

Changes made to cli.md

1. infer chat --session-id documented (Chat Interface Features section)

Added a new #### Resuming a session (--session-id) subsection after the GitHub Issue References section, documenting:

• infer chat --session-id <id> loads a persisted conversation before the TUI starts
• Requires a storage backend (storage.enabled: true)
• Session ID resolution: UUIDs used as-is, non-UUID values treated as session group keys
• Fallback semantics: prints a visible notice and starts a new session under the requested ID if the session can't be loaded
• Ignored (with notice) in --web and non-interactive (piped) modes
• Cross-link to infer agent --session-id
• Example: infer conversations list + infer chat --session-id abc-123-def

2. infer agent --session-id documented (Headless Agent section)

Added a new #### Resuming a session (--session-id) subsection after the --result-file section, documenting:

• infer agent --session-id <id> for resuming sessions in headless mode
• Same session ID resolution and fallback semantics
• Cross-link to infer chat --session-id

3. Cross-links in Conversation Management section

Updated the session ID resolution text to reference both infer agent --session-id and infer chat --session-id as linked anchors.

Draft PR: #351

Model: ollama_cloud/deepseek-v4-flash · Exit Code: 0 · Duration: 2m 45s

Tokens: 2,333,800 in · 7,079 out · 2,340,879 total (28 requests)

Tool calls: 32 total · 100% success rate

Triggered by edenreich · Infer Action

[inference-gateway-releaser]

🎉 This issue has been resolved in version 0.9.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀