Cue
Identity & Publishing

Assistant

Customize your personal agent's name and appearance

Make your agent your own. Give it a name, a face, and a personality that fits you.

What You Can Customize

SettingWhat it does
Display NameThe name shown in chats and notifications
AvatarYour agent's profile picture
PersonalityHow your agent communicates (coming soon)

Using Settings in the App

Changing Your Agent's Name

  1. Open Cue and go to Settings
  2. Tap Assistant
  3. Tap the name field and enter a new name
  4. Changes save automatically

Uploading an Avatar

  1. Go to Settings > Assistant
  2. Tap the avatar image
  3. Choose a photo from your library or take a new one
  4. Crop and confirm

Your agent's new look appears everywhere — in chats, notifications, and the home screen.

For Developers

Manage assistant settings programmatically using the Cue CLI.

Requirements

  • cue CLI installed and authenticated (cue then /auth)

Get assistant info

cue assistant get

Returns the assistant's current settings:

{
  "assistant": {
    "id": "uuid",
    "display_name": "Jarvis",
    "avatar_url": "https://...",
    "personality": null,
    "settings": {}
  },
  "conversation_id": "uuid"
}

List all assistants

cue assistant list

Returns an array of all assistants belonging to the current user.

Update display name

cue assistant update '{"display_name":"Jarvis"}'

Upload avatar

cue assistant avatar ./path/to/image.png

Supported formats: .jpg, .jpeg, .png, .gif, .webp

Returns the new avatar URLs:

{
  "avatar_url": "https://...400x400.jpg",
  "thumbnail_url": "https://...150x150.jpg"
}

Payload Format

All fields are optional:

FieldTypeDescription
display_namestringAgent's display name
settingsobjectCustom settings

Examples

Set a display name:

cue assistant update '{"display_name":"Friday"}'

Upload a new avatar:

cue assistant avatar ~/Pictures/robot-avatar.png

Check current name:

cue assistant get | jq '.assistant.display_name'

List all assistants:

cue assistant list | jq '.[].display_name'

Troubleshooting

ErrorFix
Not authenticatedRun cue then /auth to log in
Invalid JSONCheck JSON syntax
File not foundCheck the avatar file path
Unsupported formatUse .jpg, .jpeg, .png, .gif, or .webp

On this page