Skip to content

Settings: Assistants

The Assistants panel lists every assistant Wayland knows about: built-in, extension-contributed, and custom. From here you edit an assistant’s identity, pick its main agent, attach skills, and write its rules. A link at the top points to the /assistants library, the browse-and-launch surface.

The Assistants settings panel

The list shows each assistant as a card. Built-in and extension assistants are read-only in places noted below.

ControlDescription
EditOpen the edit drawer for an assistant.
DuplicateCopy an assistant into a new editable custom assistant.
CreateStart a new custom assistant from scratch.
Enabled toggleShow or hide an assistant in the launch surfaces.

Editing rights depend on the assistant type. Built-in assistants allow switching the main agent and saving; their name, description, avatar, and rules are read-only. Extension assistants are fully read-only.

FieldDescription
Name and AvatarThe display name and an emoji or icon avatar. Editable for custom assistants only.
Assistant DescriptionA short line describing what the assistant helps with. Custom only.
Main AgentThe backend agent this assistant runs on, selected from detected agents. Extension agents are tagged ext.
RulesThe assistant’s prompt, written in Markdown, with Edit and Preview tabs and an Expand toggle. Custom only.
Save / CreatePersist the assistant.
DeleteRemove a custom assistant. Hidden for built-in and extension assistants.

The skills section appears for custom assistants and for built-in assistants that carry built-in skills. Skills are grouped into collapsible sections, each with an active-count badge.

GroupDescription
Imported Skills (Library)Custom and pending skills, with a checkbox per skill and a remove action.
Builtin SkillsSkills shipped with the assistant.
Extension SkillsSkills contributed by extensions.
Auto-injected SkillsBuilt-in skills enabled by default; uncheck to disable one.
Add SkillsOpen the picker to attach more skills, including custom paths.