// Automate Stella web UI testing with tap-web browser automation. Use when the user asks to "test the UI", "check the web page", "verify the frontend", "run UI tests", "browser test", or wants to interact with stella.localhost in a browser.
| name | web-ui-test |
| description | Automate Stella web UI testing with tap-web browser automation. Use when the user asks to "test the UI", "check the web page", "verify the frontend", "run UI tests", "browser test", or wants to interact with stella.localhost in a browser. |
Automate Stella web UI verification using tap browser commands.
| Variable | Purpose | Default |
|---|---|---|
DEV_ADMIN_USER | Admin username | admin |
DEV_ADMIN_PASS | Admin password | i-am-admin |
DEV_USER | Normal user | user |
DEV_PASS | Normal pass | i-am-user |
Base URL: http://localhost:25678
mise run dev or similar).tap CLI must be installed and on $PATH.| Need | Tool |
|---|---|
| Check page text/state | tap browser text [selector] |
| Discover interactive elements | tap browser snapshot --interactive -f json |
| Fill forms / click buttons | tap browser fill / tap browser click |
| Run JS assertions | tap browser evaluate <js> |
| Check network responses | tap browser network wait --url-pattern "*/api/*" --body |
| Visual verification only | tap browser screenshot |
Prefer text and snapshot over screenshot. Only screenshot when layout/visual matters.
# Check if browser is already running
tap status
# If stale or no session, start fresh (visible window)
tap browser open "$URL" --show
# Subsequent navigations reuse the session
tap browser open "$URL"
If tap browser commands fail with connection errors, the session is stale. Fix:
rm "$HOME/.cache/tap/browser/state.json"
tap browser open "$URL" --show
tap browser open "https://stella.localhost/login"
tap browser snapshot --interactive -f json
# Clear any pre-filled values
tap browser evaluate 'document.querySelectorAll("input").forEach(i => { i.value = ""; i.dispatchEvent(new Event("input", {bubbles:true})); })'
tap browser fill @e3 "$USERNAME" @e4 "$PASSWORD" --submit @e1
sleep 1
tap browser text | head -20
# From login page, click Register
tap browser click @e2 # "Need an account? Register"
tap browser snapshot --interactive -f json
tap browser fill @e3 "$USERNAME" @e4 "$PASSWORD" @e5 "$PASSWORD" --submit @e1
sleep 1
tap browser text | head -20
tap browser text | head -30 # Quick text check
tap browser snapshot --interactive # See all interactive elements
tap browser open "https://stella.localhost/agents"
tap browser open "https://stella.localhost/settings"
After each action, verify the result before moving on:
tap browser text | head -N — confirm expected heading or content.tap status --json — confirm navigation landed on the right page.tap browser text output.If an assertion fails, report what was expected vs what was found. Do not silently continue.
@e1, @e2, ...) are invalidated after navigation — always re-snapshot.placeholder attributes: username, password./agents.Release workflow for stella Go CLI project. Create releases with semantic versioned tags, update changelog, and trigger automated CI/CD builds. Use when the user asks to "release", "create a release", "tag a version", "update changelog", "prepare release", "cut a release", or discusses versioning and release artifacts.
Self-knowledge about stella, the self-hosted AI assistant. Use when the user asks about stella itself: configuration, setup, onboarding, providers, models, agents, channels (Telegram/QQ/Feishu/WeChat), memory system (LCM), scheduled jobs, heartbeat, skills, plugins, session compaction, notifications, self-update, multi-agent, multi-user, or general "how does stella work" / "help me get started" questions. Also triggers on "change my model", "set up telegram", "set up wechat", "configure provider", "update stella", "what can you do", "how do I install skills", "stella onboard", "switch agent".
Database schema design best practices. Use when creating tables, reviewing migrations, planning data models, or answering schema design questions.
Access websites, search the web, and extract clean content using the `tap` CLI. Supports structured site scripts, readable page extraction, and browser automation for tabs, screenshots, forms, cookies, JavaScript evaluation, and network capture. Use for web lookup, page reading, content extraction, browser interaction, authenticated sessions, request interception, or CDP-connected desktop apps.
Reading assistant for saving, organizing, and recalling web content. Use when the user says "save this article", "read this link", "summarize this", "check my feeds", "add to my library", or asks about previously saved content. Handles articles, tweets, YouTube videos, GitHub repos, PDFs, and RSS feeds. Articles are stored as markdown files with metadata and indexed for fast search.
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.