Sumi Plugin Chat

Description

Start a local AI chat web service for Sumi. The plugin launches a local web UI for API key management, conversation organization, and import/export. Chat data is stored locally in SQLite, while the API key is kept in the operating system's secure credential store.

Install

sumi plugin add chat@latest

Usage

sumi chat start [port]
sumi chat open
sumi chat key set [value]
sumi chat key delete
sumi chat key status
sumi chat export [file]
sumi chat import <file>
sumi chat stop

sumi chat [port] still works as a compatibility alias for sumi chat start [port].

Commands

• start [port] - Start the local HTTP service in a background process.
  • Default port: 7860
• open - Open the running local UI in the default browser.
• key set [value] - Save the API key in the OS credential manager.
  • Use --stdin to read the key from standard input.
• key delete - Remove the saved API key.
• key status - Show whether an API key is configured.
• export [file] - Export chats and non-sensitive settings to JSON.
  • Default file name: sumi-plugin-chat-backup-<unix-timestamp>.json
• import <file> - Import chats and non-sensitive settings from JSON.
• stop - Stop the background chat service.

After start, open the printed local URL in your browser, or use sumi chat open.

Features

• Streaming assistant responses in the browser
• Secure local API key storage through the OS credential manager
• SQLite-backed local persistence for settings, chats, and messages
• Conversation rename, search, pin, archive, delete
• JSON export and import for chat history and non-sensitive settings

The server stores local data in the user config directory under sumi-plugin-chat/data.db. Exported backups intentionally exclude the saved API key.