Auto-Rename

Opengram can automatically generate descriptive titles for chats using an LLM. When an agent completes a reply in a chat that still has the default title, the auto-rename feature calls the configured LLM to produce a short, relevant title based on the conversation content.

Supported Providers

Setup

There are three ways to configure auto-rename:

1. Init wizard — run opengram init and follow the prompts to select a provider, enter an API key, and choose a model.
2. Web UI — open the Settings page in the Opengram web interface (/settings) and configure auto-rename from the browser.
3. Config file — edit opengram.config.json directly:

{
  "autoRename": {
    "enabled": true,
    "provider": "anthropic",
    "modelId": "claude-haiku-4-5",
    "apiKey": "sk-ant-..."
  }
}

API Key Resolution

The API key can be provided in two ways:

1. In the config file -- set the apiKey field in the autoRename section
2. Via environment variable -- set the provider's environment variable (see table above)

If both are set, the config file value takes precedence.

How it works

1. An agent completes a reply in a chat that still has the default title (e.g. "New Chat").
2. Opengram checks that user messages total at least 30 characters of content.
3. Opengram sends up to the first 6 messages (each truncated to 300 characters) to the configured LLM.
4. The LLM returns a short title (3--7 words), trimmed to 48 characters.
5. The chat title is updated and marked as auto-renamed.

Auto-rename only triggers once per chat -- when the title source is still default. If a user or agent has already set a custom title, auto-rename is skipped.

Configuration Options