Skip to content

Add agent nicknames to tell apart agents with the same name - #70

Merged
shashikanth-gs merged 2 commits into
mainfrom
feat/agent-nicknames
Oct 22, 2026
Merged

shashikanth-gs merged 2 commits into
mainfrom
feat/agent-nicknames

Conversation

@shashikanth-gs

Copy link
Copy Markdown
Member

What changed and why

Two registrations can advertise the same card name (for example the same agent built with LangGraph and with ADK), which makes them impossible to tell apart in lists, chat, the inbox and approvals. These two commits were pushed to claude/id-labels after #67 had already merged, so they never reached main; this puts them in a PR of their own, unchanged (cherry-picked onto current main).

  • Nicknames: optional, unique ignoring case among enabled agents, set when connecting an agent or later on the agent page. Shown instead of the card name across the console, inbox, approvals, notifications and the audit trail. The agents list also shows each card's host and port. A follow-up commit shows the advertised card name beside the nickname in the agent list, chat and the admin pages.
  • Schema: new migration Migration0009_AgentNickname and schema version 9 (adds a nullable nickname column to agents).
  • API, UI, docs (connect-an-agent.md, use-the-console.md, http-api.md) and CHANGELOG.md are updated in the same commits, with tests: agent-label.test.ts, agent-nickname-card.test.tsx, agent-store.test.ts and additions to the agent-settings and database tests.

Commits: a15e406 and f54f685 from claude/id-labels, applied as 7ff8ab9 and 3411020.

How it was verified

Only tsc --noEmit was run on the cherry-picked branch, and it is clean. A dry-run merge of the original branch into main had no conflicts. Lint was started but I did not wait for it.

Not verified, deliberately: I did not run the unit tests, the database and migration tests, the build or the HTTP scripts, and I did not wait for CI. This was merged on the user's explicit instruction to merge without waiting for builds or checks. Because it adds a schema migration, CI on main is the first real check of the migration, the new database tests and the upgrade path. Watch the verify job.

Checklist

  • Focused change, with tests in the same change
  • npm run check passes (or the part you could run is listed above) — not run; see above
  • Docs updated for the behavior you changed, per docs/contributing/documentation.md (or say why none apply)
  • Security-relevant changes update docs/security/threat-model.md (not applicable: display name only)
  • User-visible changes are in CHANGELOG.md

Generated by Claude Code

Optional, unique (ignoring case) among enabled agents, set when connecting or later on the agent page, and shown instead of the card name across the console, inbox, approvals, notifications and audit trail. The agents list also shows each card's host and port. Schema version 9.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lu73uozkZGX8gP8LWNbBqt
The nickname leads; the name on the agent's card stays visible on the agents list and page, the chat header and picker, and in brackets in dropdowns.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lu73uozkZGX8gP8LWNbBqt
@shashikanth-gs
shashikanth-gs merged commit 6e9f938 into main Oct 22, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants