# Avatar Chips

> People as chips: an avatar seated in the leading curve with a presence dot on its rim, a name and an optional role or handle, and a remove button that also answers Backspace. The list folds everyone past `max` into a chip that previews their faces with a +N, and opening it springs them in one after another.

- Slug: `avatar-chips`
- Category: [Chips](https://www.assembli.design/category/chips.md)
- Type: component
- Tags: chip, avatar, people, presence, recipients, overflow
- npm dependencies: motion
- shadcn/ui dependencies: none
- Added: 2026-10-24
- Live preview: https://www.assembli.design/preview/avatar-chips
- Page: https://www.assembli.design/components/avatar-chips

## Install

One-time setup (needs a subscription):

1. Add the registry to the project's `components.json`: `{"@assembli":{"url":"https://www.assembli.design/r/{name}.json","headers":{"Authorization":"Bearer ${ASSEMBLI_API_KEY}"}}}` (merge into `"registries"`).
2. Put an API key from https://www.assembli.design/account in `.env.local` as `ASSEMBLI_API_KEY=asm_…`.

Then install with the shadcn CLI (writes `components/avatar-chips/avatar-chips.tsx` and installs dependencies):

```bash
npx shadcn@latest add @assembli/avatar-chips
```

Registry item JSON: https://www.assembli.design/r/avatar-chips.json (send `Authorization: Bearer <api key>`)

## Code

> Component source needs an Assembli subscription ($12/month) and an API key sent as `Authorization: Bearer <key>`. To get one without copying anything, POST https://www.assembli.design/api/agent/login (or call the MCP tool connect_account), show the user the link it returns, and poll https://www.assembli.design/api/agent/token for the key. Or subscribe at https://www.assembli.design/pricing and create a key at https://www.assembli.design/account.