Agent profiles form doesn't say what its fields do or accept #1875

Open
opened 2026-11-12 09:45:55 +00:00 by sam · 2 comments
Owner

Problem

The profile card on Settings → Agent profiles gives the operator no way to know what to enter:

  • Image is empty for a profile using the default, with no hint that empty means the image from Container runtime ([containers].image), or what that image is.
  • Kit says "Used only when Image is empty", but validation rejects a profile with both (image and kit are exclusive).
  • Adapter is free text. Valid values are claude-code, codex, pi, omp, copilot, it is rejected without a Kit, and empty means no capture tools and no usage. None of that is shown.
  • Tools says "Comma-separated tool names" but is a tag input, lists no available tools, and doesn't say that empty allows every tool.

Wanted

Image and Kit as one choice (default image, custom image, or Kit), Adapter as a select shown only for a Kit, Tools picked from the tools the instance has, each with a one-line description of empty.

Done when

An operator can set up an image profile and a Kit profile from the page without reading the code.

## Problem The profile card on Settings → Agent profiles gives the operator no way to know what to enter: - **Image** is empty for a profile using the default, with no hint that empty means the image from Container runtime (`[containers].image`), or what that image is. - **Kit** says "Used only when Image is empty", but validation rejects a profile with both (`image and kit are exclusive`). - **Adapter** is free text. Valid values are `claude-code`, `codex`, `pi`, `omp`, `copilot`, it is rejected without a Kit, and empty means no capture tools and no usage. None of that is shown. - **Tools** says "Comma-separated tool names" but is a tag input, lists no available tools, and doesn't say that empty allows every tool. ## Wanted Image and Kit as one choice (default image, custom image, or Kit), Adapter as a select shown only for a Kit, Tools picked from the tools the instance has, each with a one-line description of empty. ## Done when An operator can set up an image profile and a Kit profile from the page without reading the code.
Author
Owner

After #1877 the Kit and Adapter fields go. What's left here: say that an empty Image means the Container runtime default (and show it), and make Tools a picker of the tools the instance has, with empty meaning all.


Generated by Claude Code

After #1877 the Kit and Adapter fields go. What's left here: say that an empty Image means the Container runtime default (and show it), and make Tools a picker of the tools the instance has, with empty meaning all. --- _Generated by [Claude Code](https://claude.ai/code)_
sam added the mediumbug labels 2026-11-12 15:51:31 +00:00
Author
Owner

Field descriptions added in eed9101d5; the Kit/adapter/tools-picker redesign the issue describes is still open.

Field descriptions added in eed9101d5; the Kit/adapter/tools-picker redesign the issue describes is still open.
sam added the deferred label 2026-11-15 17:26:10 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sam/archie#1875