by CX-ArtLab
BoopFace (formerly Agent Robot Avatar): a lightweight, expressive robot avatar component for AI bots, agents and interactive apps.
# Add to your Claude Code skills
git clone https://github.com/CX-ArtLab/BoopFaceGuides for using ai agents skills like BoopFace.
Last scanned: 11/17/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-11-17T12:48:22.825Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how BoopFace compares with popular alternatives.
BoopFace is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by CX-ArtLab. BoopFace (formerly Agent Robot Avatar): a lightweight, expressive robot avatar component for AI bots, agents and interactive apps. It has 186 GitHub stars.
Yes. BoopFace passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/CX-ArtLab/BoopFace" and add it to your Claude Code skills directory (see the Installation section above).
BoopFace is primarily written in JavaScript. It is open-source under CX-ArtLab on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh BoopFace against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
Official website: boopface.com
English | 简体中文 | Español | Русский | Français | Português | Deutsch | 日本語 | 한국어 | 繁體中文
BoopFace is a lightweight, expressive robot avatar component for AI bots, agents and interactive apps. Thinking, waiting, done or failed: every state of an agent can be shown as an expression.
Use it as the face and status feedback of AI assistants and agents: chat assistants like ChatGPT, Claude, Gemini, Grok and DeepSeek, coding agents like Codex, Claude Code, Cursor, Gemini CLI and OpenCode, and always-on agents like Grok Bot, ChatGPT dots, Meta Muse, OpenClaw and Hermes Agent.
It also works for desktop companions, virtual pets, digital mascots, chatbot avatars and other interactive characters, or as a visual feedback layer for AG-UI-style agent interfaces.
Built with SVG and vanilla JavaScript, it is a native Web Component with zero runtime dependencies, MIT licensed. 188 skins are ready to put on at any time.
https://github.com/user-attachments/assets/533940e6-38e8-45e3-a276-606e1e7bba51
The same eye expressions on ESP32, STM32 and Raspberry Pi Pico screens, or in other C++ programs. Includes firmware examples for 28 board/display configurations and an online simulator with settings export.
npm install boopface
import 'boopface';
Or download boopface-x.y.z.zip from the latest release. It holds only the component, skins included. Unzip it next to your page:
<script type="module" src="./boopface/boopface.js"></script>
Then add the component:
<boop-face id="avatar"></boop-face>
No initialization code is required. The avatar enters its default idle behavior automatically.
BoopFace was called Agent Robot Avatar before version 0.8. Features and usage are unchanged. To upgrade, switch the package name to boopface:
npm uninstall agent-robot-avatar
npm install boopface
The old <agent-robot-avatar> tag keeps working until 1.0, so there is no rush to change your pages. The old npm package agent-robot-avatar gets no more updates; new versions are published only as boopface.
For pages that never use skins, boopface/lite is the same avatar without any skin code:
import 'boopface/lite';
In the lite build the skin attribute is ignored, and the console notes that skins need the full build.
Size comparison (transferred over the network, gzip-compressed):
| Build | Size |
|---|---|
Lite boopface/lite |
about 45 KB |
| Full, page uses no skins | about 56 KB; the skin painting code is not downloaded |
| Full, with skins | about 113 KB; the extra part downloads the first time a skin is used |
const avatar = document.querySelector('#avatar');
avatar.play('success');
avatar.play('wary');
avatar.play('refuse');
avatar.reset();
Available actions:
| Action | Looks like | Use when |
|---|---|---|
idle |
Blinks and glances around | Default state |
bored |
Glances slowly from side to side | Nothing has happened for a while |
waiting-spin |
Eyes circle from side to side | Waiting for a reply (default) |
waiting-wrap |
Eyes slide out one side and back in the other | Waiting for a reply |
waiting-wave |
Eyes bob up and down in turn | Waiting for a reply |
input |
Eyes become blinking text cursors | The user is typing |
affirm |
Nods | Got it, confirmed |
success |
Happy, smiling eyes | Task completed |
failure |
Head and eyes droop | Task or connection failed |
wary |
Turns its head and gives a guarded up-and-down look | An action needs confirmation |
inspect |
Narrows its eyes and scans up and down | Checking or reviewing something |
angry |
Lowered, glaring eyes | Content blocked |
refuse |
Shakes its head | Cannot or will not do the request |
surprise |
Wide-open eyes | Something unexpected |
love |
Eyes merge into a beating heart | Thanks, affection |
random |
Eyes spin like slot-machine reels | Random pick, playful moment |
sleep |
Closes its eyes and sleeps | No activity for a long time |
wake |
Opens its eyes and wakes up | Activity resumes |
Waiting actions play one round with play(). startWaiting({ variant: 'spin' | 'wrap' | 'wave' }) loops until another action starts or stopWaiting() is called.
Names from 0.5 (send, warning, error, blocked, slot and others) still work with a console notice until 1.0; see the upgrade table.
For a real Agent request lifecycle:
avatar.startWaiting();
// Alternative waiting motion: eyes turn out through one side and return through the other.
avatar.startWaiting({ variant: 'wrap' });
// Alternative waiting motion: staggered vertical eye waves.
avatar.startWaiting({ variant: 'wave' });
try {
const result = await runAgentRequest();
await avatar.play(result.ok ? 'success' : 'failure');
} catch (error) {
await avatar.play('failure');
}
<boop-face
size="160"
color="#08090b"
auto-sleep="30000"
wake-on="activity"
motion="auto">
</boop-face>
| Attribute | Purpose |
|---|---|
size |
Avatar size in pixels |
color |
Main avatar color |
auto-sleep |
Idle time before automatic sleep; 0 disables it |
wake-on |
Automatic wake policy: activity, interaction, or manual |
motion |
Motion policy: auto, reduce, or full |
press-squeeze |
Center press-and-hold squeeze; set to false to disable |
antenna-drag |
Antenna drag, spring return, and angry reaction; set to false to disable |
skin |
Skin number, such as 301; leave it out for the flat color |
Common runtime controls: