Sabo/webui

Files

nesquena-hermes f9663d2f1d docs: bump to v0.49.0 — onboarding wizard release

Co-authored-by: Nathan Esquenazi <nesquena@gmail.com>

2026-04-11 23:41:10 -07:00

60 KiB

Raw Blame History

Hermes Web UI: Browser Testing Plan

This document is for manual browser testing by you or by a Claude browser agent. It covers user-facing features of the UI through Sprint 26 (v0.36.2) and later releases. Each section is written as a step-by-step test procedure with expected outcomes. A browser agent (e.g. Claude with Chrome access) can execute this plan directly.

Prerequisites: SSH tunnel is active on port 8786. Open http://localhost:8786 in browser. Server health check: curl http://127.0.0.1:8786/health should return {"status":"ok"}.

Automated tests: 693 total (693 passing, 0 skipped, 0 known failures). Includes onboarding coverage for bootstrap/static wizard presence, real provider config persistence (config.yaml + .env), and the /api/onboarding/* backend. Run: pytest tests/ -v --timeout=60

How to Use This Document

Each test has:

SETUP: what to do before the test
STEPS: numbered actions to perform
EXPECT: what you should see (pass criteria)
FAIL: what a failure looks like

Work through sections in order. Each section builds on the previous.

Section 1: Initial Load and Empty State

T1.1: Fresh Load Shows Empty State

SETUP: Clear localStorage (DevTools > Application > Local Storage > delete hermes-webui-session) or open in incognito. STEPS:

Navigate to http://localhost:8787 EXPECT:

Dark background, Hermes logo in sidebar header
Center area shows "What can I help with?" heading with suggestion buttons
Session list in sidebar is empty or shows existing sessions
No session is highlighted active
Send button is present but there is no input focus by default FAIL: Page shows error, blank white screen, or auto-creates a new session without user action.

T1.2: Suggestion Buttons Work

SETUP: T1.1 complete, no active session. STEPS:

Click "What files are in this workspace?" suggestion button EXPECT:

A new session is created automatically (since none existed)
The text "What files are in this workspace?" appears as the user message
Thinking dots appear below the user message
After a few seconds, Hermes responds FAIL: Button does nothing, error appears, or page crashes.

Section 2: Session Management

T2.1: Create New Session via + Button

SETUP: Any state. STEPS:

Click the "+ New conversation" button in the sidebar EXPECT:

A new session named "Untitled" appears highlighted in the session list
The center area shows the empty state ("What can I help with?")
The + button is the ONLY way to create a session (no auto-create on load) FAIL: Multiple sessions created, error thrown, or empty state not shown.

T2.2: Send a Message and See Response

SETUP: Active session exists. STEPS:

Click in the message input at the bottom
Type: "Say hello in exactly three words"
Press Enter (not Shift+Enter) EXPECT:

User message appears immediately in chat
Thinking dots (three animated dots) appear below
Status bar shows "Hermes is thinking..."
Send button becomes disabled (grayed out)
Within 10-30 seconds, Hermes responds with a three-word greeting
Thinking dots disappear
Send button re-enables
Session title in sidebar updates to reflect the first message FAIL: Message never appears, thinking dots never go away, Send button stays disabled forever.

T2.3: Shift+Enter Creates Newline (Does Not Send)

SETUP: Active session, input focused. STEPS:

Click the message input
Type "Line one"
Press Shift+Enter
Type "Line two" EXPECT:

Two lines of text appear in the input box
No message is sent (no user message appears in chat) FAIL: Message sent on Shift+Enter.

T2.4: Reload Restores Session

SETUP: A session exists with at least one exchange (user + assistant). STEPS:

Note the session title and last message content
Reload the page (Cmd+R or F5) EXPECT:

The same session loads automatically (no empty state)
All messages from before the reload are visible
Session title in topbar and sidebar matches what it was before FAIL: Session lost on reload, empty state shown, or messages missing.

T2.5: Delete Active Session

SETUP: At least two sessions exist. One is active. STEPS:

Hover over the active session in the sidebar (trash icon appears)
Click the trash icon on the active session EXPECT:

A "Conversation deleted" toast appears at the bottom for ~3 seconds
The deleted session disappears from the sidebar list
The next most recent session automatically loads (or empty state if none remain)
NO new session is auto-created FAIL: Session not removed, new session auto-created, error shown, or wrong session loaded.

T2.6: Delete Non-Active Session

SETUP: At least two sessions exist. Session B is not active. STEPS:

Hover over a session that is NOT currently active
Click its trash icon EXPECT:

Toast "Conversation deleted" appears
That session disappears from list
Currently active session remains active and unchanged FAIL: Active session changes, multiple sessions deleted, or error.

T2.7: Delete Last Session Shows Empty State

SETUP: Exactly one session exists. STEPS:

Delete that session via the trash icon EXPECT:

Session list is empty
Center area shows "What can I help with?" empty state
No session is auto-created FAIL: New session created, error thrown, or UI breaks.

Section 3: Model Selection

SETUP: Any active session. STEPS:

Look at the sidebar bottom: "Model" label and a dropdown
Click the dropdown to expand it EXPECT:

Provider groups visible: OpenAI, Anthropic, Other
OpenAI group: GPT-5.4 Mini, GPT-4o, o3, o4-mini
Anthropic group: Claude Sonnet 4.6, Claude Sonnet 4.5, Claude Haiku 3.5
Other group: Gemini 2.5 Pro, DeepSeek V3, Llama 4 Scout FAIL: Only 2 options visible, no groups, or missing models.

T3.2: Model Chip Reflects Selection

SETUP: Active session. STEPS:

Change model dropdown to "Claude Sonnet 4.6" EXPECT:

The blue chip in the topbar right updates to "Sonnet 4.6" immediately
NOT "GPT-5.4 Mini" (this was Bug B3, now fixed) STEPS (continued):

Change model to "Gemini 2.5 Pro" EXPECT:

Chip updates to "Gemini 2.5 Pro" (not "GPT-5.4 Mini") FAIL: Chip shows wrong model name for any non-Sonnet selection.

Section 4: File Upload

T4.1: Click-to-Attach Opens File Picker

SETUP: Active session. STEPS:

Click the paperclip icon in the composer footer EXPECT:

OS file picker dialog opens
Accepted types filter visible (images, text, PDF, common code files) FAIL: Nothing happens, error thrown.

T4.2: Attach a Text File and Send

SETUP: Have a small .txt or .py file ready to upload. STEPS:

Click the paperclip, select the file
File chip appears in the composer tray above the input
Type "What is in this file?" in the input
Press Enter EXPECT:

Upload progress bar briefly appears
User message shows the message text plus a file badge with the filename
Hermes responds describing or reading the file content FAIL: Upload fails, file badge never appears, Hermes does not mention the file.

T4.3: Drag and Drop a File

SETUP: Active session, a file ready on your desktop. STEPS:

Drag a file from Finder/Explorer over the composer area EXPECT:

Blue dashed border and "Drop files to upload to workspace" overlay appear STEPS (continued):

Drop the file EXPECT:

File chip appears in the tray
Overlay disappears FAIL: No drag visual feedback, file not accepted, error on drop.

T4.4: Paste Screenshot from Clipboard

SETUP: Take a screenshot (Cmd+Shift+4 on Mac, saves to clipboard). STEPS:

Click in the message input
Press Cmd+V (paste) EXPECT:

An image file chip appears in the tray: "screenshot-{timestamp}.png"
Status bar briefly shows "Image pasted: screenshot-..." FAIL: Nothing pasted, error, or raw binary data appears in input.

T4.5: Remove a File from Tray

SETUP: At least one file in the attach tray. STEPS:

Click the X button on a file chip in the tray EXPECT:

That file is removed from the tray
If it was the only file, tray collapses FAIL: File not removed, error.

Section 5: Workspace File Browser

T5.1: File Tree Loads on Session Start

SETUP: Active session with workspace set. EXPECT:

Right panel shows "WORKSPACE" header
File tree lists files and directories in the workspace
Directories have folder icons
Files have type-appropriate icons (camera for images, notepad for markdown, etc.) FAIL: Right panel is blank, error, or all files show generic icon regardless of type.

T5.2: Navigate Into a Directory

SETUP: Workspace has at least one subdirectory. STEPS:

Click a directory name in the file tree EXPECT:

File tree updates to show contents of that directory
A ".." or breadcrumb is NOT shown (current behavior: flat navigation) FAIL: Click does nothing, error, or entire page breaks.

T5.3: Preview a Code File

SETUP: Workspace has a .py or .js or .txt file. STEPS:

Click the file name in the tree EXPECT:

Right panel switches from file tree to preview area
File path shown at top with file extension badge (gray)
File contents shown as monospace text (raw code)
File tree is hidden, preview is visible FAIL: Nothing happens, binary gibberish shown, crash.

T5.4: Close Preview Returns to File Tree

SETUP: T5.3 complete, preview is showing. STEPS:

Click the X button in the panel header EXPECT:

Preview closes
File tree is visible again
Preview area is hidden
Reopening the same file shows fresh content (no stale cached text) FAIL: X button does nothing, tree does not reappear.

T5.5: Preview an Image File (Sprint 2)

SETUP: Upload a PNG, JPG, or any image file to the workspace, OR the workspace already contains one. STEPS:

Click an image file (e.g. .png or .jpg) in the file tree EXPECT:

Preview area shows the actual image rendered inline (NOT a blob of bytes or placeholder)
Image is centered, fits within the panel width
Path bar shows "image" badge in blue
Image maintains aspect ratio FAIL: Raw binary text displayed, broken image icon, error message, or nothing happens.

T5.6: Preview a Markdown File (Sprint 2)

SETUP: Workspace has a .md file (or create one: upload a file named README.md with some markdown content). STEPS:

Click the .md file in the file tree EXPECT:

Preview shows formatted, rendered markdown (NOT raw text with asterisks)
Headings render as large bold text
bold renders as bold, italic as italic
Bullet lists render as actual list items
Code blocks render in monospace with dark background
Path bar shows "md" badge in gold FAIL: Raw markdown text with asterisks/hashes shown, or no preview at all.

T5.7: Markdown Preview Renders Tables (Sprint 2)

SETUP: Upload or create a .md file with a table like:

Name	Value
foo	bar
STEPS:

Click the file in the file tree EXPECT:

Table renders as an actual HTML table with borders
Column headers (Name, Value) are bold/highlighted
Data rows alternate subtle background FAIL: Table displayed as raw pipe-separated text.

T5.8: Refresh Files Button

SETUP: Active session, workspace has files. STEPS:

Click the "Files" refresh button in the sidebar bottom actions EXPECT:

File tree reloads
If a file was added externally, it now appears FAIL: Error, spinner never stops, tree clears without reloading.

Section 6: Workspace Path

T6.1: Change Workspace Path

SETUP: Active session. STEPS:

Click the workspace path display in the sidebar bottom (shows current path)
A prompt dialog appears
Enter a new valid path (e.g. /tmp)
Click OK EXPECT:

Workspace chip in topbar updates to show the last segment of the new path
File tree refreshes to show files at the new path
Next message sent uses the new workspace FAIL: Dialog does not appear, path not saved, error on invalid path.

Section 7: Tool Approval

T7.1: Dangerous Command Shows Approval Card

SETUP: Active session with a test-workspace (NOT a production directory). STEPS:

Type: "Run the command: rm -rf /tmp/hermes_test_delete_me"
Send the message EXPECT:

Thinking dots appear
An orange/red approval card appears above the composer: "Dangerous command - approval required"
The card shows the command text
The card shows the pattern description (e.g. "recursive delete [recursive_delete]")
Four buttons: Allow once, Allow this session, Always allow, Deny FAIL: No card appears, agent executes without asking, page crashes.

T7.2: Deny Approval Blocks the Command

SETUP: T7.1 complete, card is showing. STEPS:

Click "Deny" EXPECT:

Approval card disappears
Agent responds with a message indicating the command was denied/blocked
No file was deleted FAIL: Command executes despite deny, card stays up, error.

T7.3: Allow Once Executes the Command

SETUP: Create a safe test: type "Run: touch /tmp/hermes_approval_test.txt" STEPS:

Send the message
When approval card appears, click "Allow once" EXPECT:

Approval card disappears
Agent continues and reports the command ran successfully
Verify: open a terminal and run: ls /tmp/hermes_approval_test.txt FAIL: Command blocked after Allow once, card stays, error.

Section 8: Transcript Download

T8.1: Download Conversation as Markdown

SETUP: A session with at least 2 messages (1 user + 1 assistant). STEPS:

Click the "Transcript" download button in the sidebar bottom EXPECT:

Browser downloads a .md file named hermes-{session_id}.md
Opening the file shows the conversation in markdown format:
user
(message text)
assistant
(response text) FAIL: No download triggered, file is empty, file is corrupted JSON instead of markdown.

Section 9: Reconnect Banner (Sprint 1 - B4/B5)

T9.1: Reconnect Banner After Mid-Stream Reload

NOTE: This test requires deliberate timing. Best done with a slow/long agent request. SETUP: Active session. STEPS:

Send a message that will take a while (e.g. "Write me a 500-word short story")
While thinking dots are showing (within the first 5 seconds), reload the page (Cmd+R) EXPECT:

Page reloads and restores the session
A gold/amber banner appears near the top: "A response may have been in progress..."
Two buttons on the banner: "Dismiss" and "Reload"
Clicking "Reload" fetches fresh messages from server
Clicking "Dismiss" removes the banner FAIL: No banner shown, page crashes, banner appears on normal reloads with no in-flight request.

Section 10: Multi-Session and Concurrent Behavior

T10.1: Switch Sessions While Response Is Loading

SETUP: Active session, agent running (thinking dots visible from a previous message). STEPS:

While thinking dots are showing, click a DIFFERENT session in the sidebar EXPECT:

The new session loads cleanly (its messages show)
The Send button for the NEW session is NOT disabled (it's not busy)
The original session's response is still being generated in the background
Clicking back to the original session shows the thinking dots still running
When the original request finishes, its messages update correctly FAIL: New session shows busy state, switching breaks messages, response lands in wrong session.

T10.2: Multiple Sessions in List (Up to 30)

SETUP: Create enough sessions to have at least 5 in the sidebar. EXPECT:

Sessions listed most-recently-updated first
Long titles truncate with "..." and do not overflow the sidebar width
Hover shows the trash icon on any session FAIL: Titles overflow sidebar, order is wrong, trash icon never appears.

Section 11: Visual and Layout Checks

T11.1: Right Panel Hidden on Small Screens

STEPS:

Resize browser window to below 900px width EXPECT:

Right panel (workspace) disappears
Chat area expands to fill the full width FAIL: Right panel overlaps chat or causes horizontal scroll.

T11.2: Sidebar Hidden on Very Small Screens

STEPS:

Resize browser window to below 640px width EXPECT:

Left sidebar disappears
Chat area takes full width FAIL: Sidebar causes layout overflow or blocks chat.

T11.3: Structured Log Output

SETUP: SSH access to the server. STEPS:

In a terminal: tail -f /tmp/webui-mvp.log
In browser: perform any action (load page, send message, click file) EXPECT:

Log entries appear in terminal as JSON: {"ts":"...","method":"GET","path":"/health","status":200,"ms":0.1}
Every request produces one log line
Status codes are correct (200 for success, 400 for bad requests) FAIL: No log output, log shows Apache-style text instead of JSON, log file not created.

Section 12: Error Handling

T12.1: Send Button Disabled When Busy

SETUP: Message is sending (thinking dots visible). EXPECT:

Send button is visually grayed out
Pressing Enter does NOT send another message
Clicking Send button does nothing FAIL: Multiple messages sent while one is in flight.

T12.2: Upload Failure Shows Status

SETUP: Active session. STEPS:

Try to attach a file larger than 20MB (if available) EXPECT:

Status bar shows an error message about file size or the upload is rejected
The chat is not broken (can still send messages) FAIL: Uncaught error, page crashes, or no feedback given.

T12.3: File Preview for Binary Non-Image

SETUP: Workspace has a .zip or .bin file. STEPS:

Click the binary file in the file tree EXPECT:

Code preview shows some text (may be replacement characters for binary content)
OR a "File too large" or "Could not open file" error in the status bar
Page does NOT crash FAIL: Browser freezes, crash, or security issue.

Automated Test Coverage Reference

These behaviors are verified by pytest (run: venv/bin/python -m pytest webui-mvp/tests/ -v):

Sprint 1 tests (test_sprint1.py):

Server health, session CRUD (create/load/update/delete/sort)
B11 footgun fix (/api/session 400 on missing ID)
Multipart parser: text file, binary PNG
HTTP upload: success, too large, no file field, bad session
Approval API: pending, inject+deny, inject+session-approve
Stream status endpoint
File listing, path traversal block

Sprint 2 tests (test_sprint2.py):

GET /api/file/raw: PNG, JPEG, SVG content-types
GET /api/file/raw: path traversal blocked, missing file 404
GET /api/file: markdown content returned as text
GET /api/file: markdown with table content preserved
GET /api/list: image and markdown files appear in directory listing

Manual-only tests (not covered by automation):

All browser rendering tests (T5.5, T5.6, T5.7 -- visual verification)
T7.1-T7.3 -- tool approval card (requires live agent execution)
T9.1 -- reconnect banner timing
T10.1 -- concurrent session switching
T11.1, T11.2 -- responsive layout
T11.3 -- log output verification
All visual/CSS checks

Claude Browser Agent Instructions

If you are a Claude agent with browser access, follow these instructions:

Navigate to http://localhost:8787 (assumes SSH tunnel is active from your Mac).
Execute tests in order. For each test: a. Follow SETUP instructions. b. Perform each STEP using browser tools (click, type, navigate). c. Use browser_vision or browser_snapshot to verify EXPECT conditions. d. Record PASS or FAIL with a brief note on what you observed.
For tests requiring file uploads: use the browser's file picker; you may need to create test files in /tmp first via terminal.
For T7.x (approval tests): the agent running inside Hermes needs to detect a dangerous command. Ask Hermes to "run: rm -rf /tmp/test_hermes_approval" and watch for the card. The actual rm will not run in a safe test workspace.
Skip T9.1 (reconnect banner) unless you can precisely time a page reload during an active SSE stream.
Report results as a checklist at the end.

Last updated: Sprint 2, March 30, 2026 Server version: v0.4 (server.py in webui-mvp/) Run automated tests: python -m pytest tests/ -v

T13.1: Four Tabs Visible in Sidebar

EXPECT:

Four tabs at top of sidebar: Chat, Tasks, Skills, Memory (with icons)
Chat tab is active/highlighted by default on load FAIL: Only one section visible, no tabs shown.

T13.2: Tab Switching Preserves Chat State

STEPS:

Send a message, get a response (so chat has content)
Click the "Tasks" tab
Click the "Chat" tab EXPECT:

When on Tasks tab: session list disappears, cron list appears
When back on Chat: full conversation is still there, session list returns
Send button still works after switching back FAIL: Messages lost, session list blank, Send button broken.

Section 14: Tasks Panel (Cron Viewer) (Sprint 3)

T14.1: Tasks Tab Shows Cron Jobs

STEPS:

Click the "Tasks" tab in the sidebar EXPECT:

A list of scheduled jobs appears
Each job shows its name and a status badge (active/paused/error/off)
At least one job visible ("Morning Crypto Update" or similar) FAIL: Empty list, loading spinner forever, error message.

T14.2: Expand a Job Row

STEPS:

Click a job name/row in the Tasks panel EXPECT:

Row expands to show: schedule string, prompt text (truncated), action buttons
"Run now" button (blue), "Pause" or "Resume" button
Last output section showing timestamp and content from the last run FAIL: Click does nothing, no expansion, buttons missing.

T14.3: Pause and Resume a Job

STEPS:

Expand an active job
Click "Pause" EXPECT:

Toast: job paused
Job list reloads, status badge changes to "paused"
Button changes to "Resume" STEPS (continued):

Click "Resume" EXPECT:

Toast: job resumed
Status badge returns to "active" FAIL: Status doesn't change, error toast.

T14.4: Last Output Shows Real Content

SETUP: At least one job has run at least once. STEPS:

Expand a job that has run EXPECT:

Last output section shows a timestamp (e.g. "2026-03-30_16-00-37")
Content preview of the last run output (first ~600 chars) FAIL: "(no runs yet)" shown even though job has run, or content is garbled.

Section 15: Skills Panel (Sprint 3)

T15.1: Skills Tab Shows Categorized List

STEPS:

Click the "Skills" tab EXPECT:

A search box at the top
Skills grouped by category with folder icons and count (e.g. "autonomous-ai-agents (4)")
Individual skill items with name and short description excerpt FAIL: Loading forever, empty list, uncategorized blob.

T15.2: Search Filters Skills

STEPS:

Click the Skills tab
Type "github" in the search box EXPECT:

List narrows to only skills matching "github" in name, description, or category
Categories with no matches are hidden STEPS (continued):

Clear the search box EXPECT:

Full list returns FAIL: Search does nothing, list disappears entirely.

T15.3: Click Skill Opens SKILL.md in Right Panel

STEPS:

Click the Skills tab
Click any skill name (e.g. "dogfood") EXPECT:

The right workspace panel switches to preview mode
The skill's SKILL.md content renders as formatted markdown
Path bar shows the skill name with gold "skill" badge
Headings, bold, lists all render correctly (not raw asterisks) FAIL: Nothing happens in right panel, raw markdown text shown, error.

Section 16: Memory Panel (Sprint 3)

T16.1: Memory Tab Shows Personal Notes

STEPS:

Click the "Memory" tab EXPECT:

Two sections: "My Notes" and "User Profile"
Each section has a last-modified timestamp in the header
Content renders as formatted markdown (not raw text) FAIL: Blank, loading forever, error, raw text with § symbols.

T16.2: Memory Content is Accurate

STEPS:

Open Memory tab
Check a fact you know is in memory (e.g. your Pacific Time preference) EXPECT:

The fact appears in the correct section (User Profile or My Notes) FAIL: Wrong content shown, different user's data, empty even though memory exists.

Section 17: Bug Fix Verification (Sprint 3)

T17.1: B6 - New Session Inherits Workspace

SETUP: Active session with workspace changed to a non-default path (e.g. /tmp). STEPS:

Click + New conversation while workspace is set to /tmp EXPECT:

New session shows /tmp in the workspace chip and path display
File tree shows files from /tmp FAIL: New session resets to default test-workspace.

T17.2: B10 - Tool Events Replace Thinking Dots

SETUP: Send a message that will trigger tool use (e.g. "What files are in /tmp?"). STEPS:

Watch the chat area carefully after sending EXPECT:

Thinking dots appear immediately
When first tool fires: dots disappear, replaced by a compact "Running terminal..." row
When first token arrives: tool row disappears, streaming text begins
NOT: thinking dots AND "Running..." AND streaming text all visible at once FAIL: Thinking dots stay while tool runs, or multiple rows stacked confusingly.

T17.3: B14 - Cmd/Ctrl+K Creates New Chat

STEPS:

Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) while on the Chat tab EXPECT:

A new "Untitled" session is created
Empty state shown, input focused
Does NOT work if a request is in-flight (Send is disabled) FAIL: Nothing happens, browser intercepts shortcut for its own purpose, crash.

Automated Test Coverage (Updated Sprint 3)

Sprint 3 tests (test_sprint3.py) - 21 tests:

Cron API: list, required fields, output, pause/resume validation, run nonexistent
Skills API: list, required fields, content for known skill, name required
Memory API: both files returned, string types, mtime keys present
Input validation: session/update, session/delete, chat/start require fields; chat/start requires message; session/update unknown ID returns 404
B6: new session with workspace param sets it correctly

Manual-only (not covered by automation):

T13.x - T16.x: all visual panel rendering tests
T17.1-T17.3: bug fix verification (B6/B10/B14)
All previous manual tests from Sections 1-12

Last updated: Sprint 3, March 30, 2026 Total automated tests: 48/48 Run: python -m pytest tests/ -v

Section 18: Source Relocation Verification (Sprint 4)

T18.1: UI Loads and CSS Renders Correctly After Relocation

STEPS:

Open http://localhost:8787 EXPECT:

Dark background, correct colors, sidebar visible
Open DevTools Network tab: verify style.css loads from /static/style.css (not inline)
No CSS errors in console FAIL: Plain unstyled HTML, white background, console errors about missing stylesheet.

Section 19: Session Rename (Sprint 4)

T19.1: Double-Click to Rename a Session

SETUP: At least one session in the sidebar. STEPS:

Double-click on a session title in the sidebar EXPECT:

The title text is replaced by an editable input field, pre-selected
Input has a blue border style
Sidebar click does NOT navigate away (click is stopped) FAIL: Nothing happens, navigation fires, input not focused.

T19.2: Enter Commits the Rename

STEPS (continued from T19.1):

Clear the input and type "My Renamed Session"
Press Enter EXPECT:

Input disappears, replaced by the new title text
Sidebar shows "My Renamed Session"
If this was the active session, topbar title also updates immediately
Page reload: title persists FAIL: Title reverts, topbar doesn't update, enter not handled.

T19.3: Escape Cancels the Rename

STEPS:

Double-click a session to start editing
Type some changes
Press Escape EXPECT:

Input disappears, original title restored (no change) FAIL: Title changed despite Escape, crash.

T19.4: Blur (Click Away) Commits the Rename

STEPS:

Double-click a session, type a new name
Click somewhere else on the page (not the input) EXPECT:

New title is committed (same as pressing Enter) FAIL: Title reverts on blur.

Section 20: Session Search (Sprint 4)

SETUP: Multiple sessions with different titles (including at least one you renamed in T19). STEPS:

Verify the Chat tab is active in the sidebar
Type part of a known session title in the "Filter conversations..." box EXPECT:

List updates live as you type, showing only matching sessions
Non-matching sessions disappear
No network request (filtering is instant, client-side) FAIL: All sessions shown regardless, search causes page reload, error.

T20.2: Clear Search Restores Full List

STEPS (continued):

Clear the search input EXPECT:

Full session list returns immediately FAIL: List stays filtered after clearing.

T20.3: No Match Shows Empty List

STEPS:

Type "zzznomatch9999" in the search box EXPECT:

Session list is empty (no items)
No error message, just empty FAIL: Error shown, crash, or unfiltered list still displayed.

Section 21: Workspace File Operations (Sprint 4)

T21.1: Delete Button Appears on File Hover

SETUP: Workspace has at least one file. STEPS:

Hover over a file in the right panel file tree EXPECT:

A small trash icon appears on the right side of the file row
Hovering away hides it again FAIL: No icon ever appears, icon always visible (not hover-only).

T21.2: Delete a File with Confirmation

STEPS:

Hover over a file and click its trash icon
A browser confirm dialog appears: "Delete [filename]?"
Click OK EXPECT:

Toast: "Deleted [filename]"
File disappears from the tree
If the file was open in the preview panel, preview closes FAIL: File not deleted, no confirmation dialog, error.

T21.3: Cancel Delete Does Nothing

STEPS:

Hover over a file and click its trash icon
Click Cancel on the confirm dialog EXPECT:

File remains in the tree
No toast, no error FAIL: File deleted despite cancel.

T21.4: Create a New File

STEPS:

Click the + button in the workspace panel header
A prompt dialog appears: "New file name (e.g. notes.md):"
Type "test-sprint4.md" and click OK EXPECT:

Toast: "Created test-sprint4.md"
File appears in the tree
File opens immediately in the preview panel
File is empty (no content) FAIL: Nothing happens, error, file not created.

T21.5: Create File Validates Name

STEPS:

Click + for a new file
Press Cancel or leave name empty EXPECT:

Nothing created, no error FAIL: Empty-named file created, crash.

Automated Test Coverage (Updated Sprint 4)

Sprint 4 tests (test_sprint4.py) - 20 tests:

Relocation: server health, static CSS served, unknown static 404
Session rename: success, persistence, truncation, missing fields, unknown ID
Session search: matches found, empty query, no results
File create: success, missing fields, duplicate rejected
File delete: success, missing file 404, path traversal blocked
Validation: /api/list and /api/file require session_id and path

Total automated: 68/68 passing.

Manual-only for Sprint 4:

T18.1: visual CSS verification
T19.1-T19.4: inline rename UX
T20.1-T20.3: live search UX
T21.1-T21.5: file operations UX

Section 22: Workspace Management (Sprint 5)

T22.1: Spaces Tab Shows Configured Workspaces

STEPS:

Click the "Spaces" tab in the sidebar (folder icon) EXPECT:

A list of workspaces with name and path
At least the default workspace (test-workspace) listed
An "Add workspace path" input at the bottom
Each workspace has "Use" and X (remove) buttons FAIL: Empty panel, loading forever, error.

T22.2: Add a Valid Workspace Path

STEPS:

Type "/tmp" in the add input and click + Add EXPECT:

"/tmp" appears in the list with name "tmp"
Toast: "Workspace added" FAIL: Error shown, path not saved, no feedback.

T22.3: Add an Invalid Path is Rejected

STEPS:

Type "/this/path/does/not/exist" in the add input and click + Add EXPECT:

Status bar shows an error (e.g. "Path does not exist")
Path is NOT added to the list FAIL: Invalid path added, no error.

T22.4: Remove a Workspace

STEPS:

Click the X button next to any non-default workspace
Confirm the dialog EXPECT:

Workspace disappears from the list
Toast: "Workspace removed" FAIL: Workspace stays, no confirmation, error.

STEPS:

In any active chat session, look at the topbar right side
Click the workspace chip (shows folder icon + workspace name + arrow) EXPECT:

A dropdown appears listing all configured workspaces
Current workspace is highlighted
A "Manage workspaces" link at the bottom FAIL: Nothing happens, no dropdown, error.

T22.6: Quick-Switch Workspace via Topbar

SETUP: At least two workspaces configured (add /tmp if needed via Spaces tab). STEPS:

Click the workspace chip to open the dropdown
Click a different workspace than the current one EXPECT:

Dropdown closes
Toast: "Switched to [name]"
Workspace chip in topbar updates to the new workspace name
File tree in right panel refreshes to show files in the new workspace
Current session is now using the new workspace FAIL: Workspace chip doesn't update, file tree unchanged, error.

T22.7: New Session Inherits Last Used Workspace

SETUP: Switch to a non-default workspace (e.g. /tmp) via the topbar dropdown. STEPS:

Click + New conversation EXPECT:

New session's workspace chip shows the same workspace you last switched to (/tmp)
File tree shows files from /tmp FAIL: New session defaults back to test-workspace.

Section 23: Copy Message to Clipboard (Sprint 5)

T23.1: Copy Icon Appears on Hover

SETUP: A chat session with at least one message. STEPS:

Hover over any chat message (user or assistant) EXPECT:

A small clipboard icon appears in the message header row (right side of "You" or "Hermes")
Icon is not visible when not hovering FAIL: No icon ever appears, always visible.

T23.2: Copy Puts Text in Clipboard

STEPS:

Hover over an assistant message
Click the clipboard icon EXPECT:

Icon briefly shows a checkmark (✓) then reverts to clipboard
Paste (Cmd+V) elsewhere shows the full text of that message FAIL: No visual feedback, clipboard empty or wrong content.

Section 24: Inline File Editor (Sprint 5)

T24.1: Code File Opens in Read-Only Mode

STEPS:

Click any .py, .js, or .txt file in the workspace file tree EXPECT:

File content shows in read-only monospace view
An "✎ Edit" button is visible in the preview path bar
Content is NOT editable (clicking in it does nothing) FAIL: Content immediately editable, no Edit button.

T24.2: Edit Button Enters Edit Mode

STEPS:

Click "✎ Edit" on a code file preview EXPECT:

Read-only view replaced by an editable textarea
Content of the file is pre-populated in the textarea
Button changes to "💾 Save" FAIL: Nothing changes, button doesn't change.

T24.3: Save Writes Changes to Disk

STEPS:

In edit mode, change some text
Click "💾 Save" EXPECT:

Read-only view returns, showing the updated content
Toast: "Saved"
Verify: refreshing the file tree and reopening the file shows the new content FAIL: Save does nothing, content reverts, error.

T24.4: Dirty Indicator Shows Unsaved Changes

STEPS:

Enter edit mode on a file
Make any change (type a character) EXPECT:

Button shows "💾 Save*" (asterisk indicates unsaved changes) FAIL: No asterisk, button stays as "💾 Save".

T24.5: Markdown File Edit-Save Roundtrip

STEPS:

Click a .md file in the workspace
Click Edit
Add a new line: "## Added by Sprint 5 test"
Click Save EXPECT:

Save succeeds (toast)
Markdown view re-renders showing the new heading FAIL: Save fails, markdown not re-rendered.

Automated Test Coverage (Updated Sprint 5)

Sprint 5 tests (test_sprint5.py) - 18 tests:

Phase A: app.js served correctly
Workspace CRUD: list, add valid, add invalid path, add invalid dir, add duplicate, requires path, remove, rename, rename unknown
Last workspace tracking: updates on session/update, new session inherits last
File save: success, missing fields, nonexistent file 404, path traversal blocked
Session index: created after save, sessions sorted correctly

Total automated: 86/86 passing.

Manual-only for Sprint 5:

T22.1-T22.7: workspace UI (tabs, dropdown, switching, inheritance)
T23.1-T23.2: copy to clipboard UX
T24.1-T24.5: inline file editor UX

Last updated: Sprint 5, March 30, 2026 Total automated tests: 86/86 Run: python -m pytest tests/ -v Source: / | Static: static/style.css + static/app.js

Section 25: UI Polish Pass (Post-Sprint 5 Visual Audit)

These are visual regression checks. Take a screenshot after loading the UI and compare against each criterion below. A Claude browser agent can verify these with browser_vision.

T25.1: Sidebar Nav Tabs are Icon-Only

EXPECT:

Five icon-only tabs in the sidebar nav row: 💬 ⏱️ 📚 🧠 📁
No text labels visible by default (text removed to prevent overflow)
Hovering a tab shows a tooltip with the label (Chat/Tasks/Skills/Memory/Spaces)
Active tab has a blue underline, icon brighter blue
All five icons fit in the sidebar width without clipping FAIL: Text labels showing alongside icons causing overflow, "Spaces" tab cut off.

T25.2: Message Role Labels are Softer

EXPECT:

"You" and "Hermes" labels appear in slightly muted blue/gold (not full-brightness)
Labels use Title Case not ALL CAPS
Role icons are circles (not squares) with a subtle border
The role label area does not visually overpower the message content below FAIL: Bright gold "HERMES" and blue "YOU" in caps drawing eye away from content.

T25.3: Code Blocks Have a Connected Language Header

EXPECT:

When a code block has a language, the header bar is connected (no gap) to the code
Header has a small colored dot on the left and the language name
Background: slightly lighter than the code body to distinguish it FAIL: Header floats above the code block with visible gap.

T25.4: Send Button Has Depth

EXPECT:

Send button has a subtle gradient (lighter at top, slightly darker at bottom)
Hover: button shifts very slightly upward (1px transform)
Visual distinction from the blue link/chip color FAIL: Send button is same flat blue as all other blue elements.

T25.5: Session List Shows Date Groups

EXPECT:

Sessions grouped under "Today", "Yesterday", "Earlier" headers
Headers are small, all-caps, muted gray
Active session has a blue left border accent FAIL: No grouping, flat list, no visual hierarchy.

T25.6: Empty State Logo is Distinct

EXPECT:

The "H" logo on the empty state is a frosted-glass circle outline style (blue tint)
NOT the same orange/red gradient as the sidebar header logo
They should look different so it's clear they're two different things FAIL: Both logos look identical.

T25.7: New Conversation Button is Blue-Tinted

EXPECT:

The "New conversation" button has a subtle blue background tint
Blue-colored text (not plain white/muted)
Feels clickable and primary (not the same style as the secondary sm-btn buttons) FAIL: Button looks same as other secondary buttons.

T25.8: Suggestion Buttons Slide on Hover

EXPECT:

On the empty state, hovering a suggestion button shifts it slightly right (2px)
Border turns blue on hover
Subtle background tint on hover FAIL: No hover movement, generic hover state.

T25.9: Toast Notification is Premium

EXPECT:

Toast appears at bottom center with blur/frosted-glass background
Subtle shadow behind the toast
Toast slightly floats up (translateY) when appearing FAIL: Plain flat dark box, no blur, no movement.

T25.10: Composer Input Has Glow on Focus

EXPECT:

Clicking in the composer/message input shows a blue glow ring around the box
(box-shadow: 0 0 0 3px rgba(124,185,255,0.08))
Border also brightens to a stronger blue FAIL: Only border color change, no glow ring.

Section 26: Resizable Panels (Sprint 6)

T26.1: Sidebar Can Be Resized by Dragging

STEPS:

Hover over the right edge of the left sidebar (between sidebar and chat area) EXPECT:

Cursor changes to col-resize (double-headed horizontal arrow)
A subtle blue glow appears on the edge STEPS (continued):

Click and drag the edge to the right EXPECT:

Sidebar widens in real time as you drag
Chat area compresses to compensate
Minimum width ~180px, maximum ~420px
Releasing the mouse commits the new width
Hard-refreshing the page restores the saved width FAIL: Cursor doesn't change, panel doesn't resize, width not saved.

T26.2: Workspace Panel Can Be Resized by Dragging

STEPS:

Hover over the left edge of the right workspace panel
Drag left to narrow, drag right to widen EXPECT:

Panel resizes within 180-500px range
Width persists across page reload (stored in localStorage) FAIL: Panel not resizable.

Section 27: Cron Job Create (Sprint 6)

T27.1: New Job Button Opens Form

STEPS:

Click the Tasks tab in the sidebar
Click the "+ New job" button at the top of the Tasks panel EXPECT:

A form slides in below the header with:
- Name input (optional)
- Schedule input (cron expression or natural language)
- Prompt textarea
- Delivery target dropdown
- Create job and Cancel buttons FAIL: Nothing happens, no form appears.

T27.2: Create a Job Successfully

STEPS:

Open the create form (T27.1)
Fill in: Name "Test Job", Schedule "every 999h", Prompt "Say hello"
Click Create job EXPECT:

Form closes
Toast: "Job created ✓"
New job appears in the cron list with status "active" FAIL: Error shown, job not created, form stays open.

T27.3: Invalid Schedule Shows Error

STEPS:

Open the create form
Leave schedule empty or type "not_a_schedule"
Click Create job EXPECT:

Error message appears below the form: "Schedule is required" or parse error
Form stays open (not dismissed) FAIL: Form closes without feedback, generic error.

T27.4: Cancel Closes Form Without Creating

STEPS:

Open the create form, fill in some fields
Click Cancel EXPECT:

Form closes
No new job created
No toast FAIL: Job created, form doesn't close.

Section 28: Session JSON Export (Sprint 6)

T28.1: JSON Export Button Downloads File

SETUP: Active session with at least a few messages. STEPS:

Click the "JSON" button in the sidebar footer (next to Transcript) EXPECT:

Browser downloads a file named hermes-{session_id}.json
Opening the file shows valid JSON with: session_id, title, messages array, workspace, model, created_at, updated_at
messages array contains objects with role and content fields FAIL: No download triggered, file is empty, file is not valid JSON.

T28.2: Escape Cancels File Editor

SETUP: Open a text file in the workspace right panel (click any .py or .md file). STEPS:

Click "Edit" button in the preview path bar
Make some changes in the textarea
Press Escape EXPECT:

Textarea disappears, read-only view returns
Original content is shown (changes discarded)
File on disk is unchanged (verify by closing and reopening the file) FAIL: Escape does nothing, changes are saved, crash.

Automated Test Coverage (Updated Sprint 6)

Sprint 6 tests (test_sprint6.py) - 16 tests:

Phase E: HTML served from static/index.html, server.py has no inline HTML
Phase D: approval/respond requires session_id and valid choice; file/raw validates session
Cron create: requires prompt, requires schedule, invalid schedule returns 400, success
Session export: requires session_id, unknown session 404, valid JSON with session_id
Resize: static files contain resize handles and resize JS logic

Total automated: 106/106 passing.

Manual-only for Sprint 6:

T26.1-T26.2: resize drag UX
T27.1-T27.4: cron create form UX
T28.1: JSON export download
T28.2: Escape from file editor

Static: static/index.html + static/style.css + static/app.js

Section 29: Cron Edit and Delete (Sprint 7)

T29.1: Edit Button Opens Inline Form

SETUP: At least one cron job exists. Tasks tab open. STEPS:

Click a cron job to expand it
Click the "Edit" (pencil) button EXPECT:

An inline form appears inside the expanded cron body
Name, schedule, and prompt fields are pre-filled with current values FAIL: Nothing happens, new form not shown.

T29.2: Save Edit Updates the Job

STEPS (continued from T29.1):

Change the name field to "Renamed Job"
Click Save EXPECT:

Form closes, toast "Job updated ✓"
Job header shows new name FAIL: Save fails, name unchanged.

T29.3: Delete Button Removes the Job

SETUP: A cron job you can safely delete (or a test job created for this). STEPS:

Expand the job, click "Delete"
Confirm the dialog EXPECT:

Toast: "Job deleted"
Job disappears from the list FAIL: Job stays, no confirmation dialog.

Section 30: Skill Create and Edit (Sprint 7)

T30.1: New Skill Button Opens Form

STEPS:

Click the Skills tab
Click "+ New skill" button EXPECT:

A form appears with name, category, and content textarea fields FAIL: Nothing happens.

T30.2: Create a Skill and See it in List

STEPS:

Fill in: Name "test-ui-skill", Content "--- name: test-ui-skill description: UI test. tags: [test]

Test"

Click Save skill EXPECT:

Toast "Skill created ✓", form closes
Skill appears in the skills list FAIL: Error, skill not in list.

T30.3: Cancel Closes Form Without Creating

STEPS:

Open new skill form, fill some fields, click Cancel EXPECT:

Form closes, no skill created FAIL: Skill created, form stays.

Section 31: Memory Inline Edit (Sprint 7)

T31.1: Edit Button Opens Memory Edit Form

STEPS:

Click the Memory tab
Click the "Edit" (pencil) button in the header EXPECT:

An edit form appears below the memory panel with a textarea pre-filled with MEMORY.md content FAIL: Nothing happens, no form.

T31.2: Save Writes Changes

STEPS:

In edit mode, add a line to the textarea
Click Save EXPECT:

Toast "Memory saved ✓", form closes
Memory panel reloads showing the updated content FAIL: Save fails, content unchanged.

T31.3: Cancel Discards Changes

STEPS:

Open edit form, change content, click Cancel EXPECT:

Form closes, original content unchanged FAIL: Changes saved despite cancel.

Automated Test Coverage (Updated Sprint 7)

Sprint 7 tests (test_sprint7.py) - 19 tests:

Health: active_streams field, uptime_seconds field
Session search: empty query, content+depth params accepted, count returned
Cron update: requires job_id, unknown job 404
Cron delete: requires job_id, unknown job 404
Skill save: requires name, requires content, invalid name rejected, create+delete roundtrip
Skill delete: requires name, unknown skill 404
Memory write: requires section, requires content, invalid section, write+read roundtrip

Total automated: 125/125 passing.

Manual-only for Sprint 7:

T29.1-T29.3: cron edit/delete UX
T30.1-T30.3: skill create UX
T31.1-T31.3: memory edit UX

Section 32: Edit User Message + Regenerate (Sprint 8)

T32.1: Edit Icon Appears on Hover

SETUP: Active session with at least one user message. STEPS:

Hover over any user message bubble EXPECT:

A pencil (edit) icon appears in the message header row, right side
Icon not visible when not hovering FAIL: No icon, always visible, wrong position.

T32.2: Click Edit Opens Textarea

STEPS:

Hover over a user message and click the pencil icon EXPECT:

Message body is replaced by an editable textarea pre-filled with the original text
"Send edit" and "Cancel" buttons appear below
Textarea has a blue border glow (focused style) FAIL: Nothing happens, empty textarea, crash.

T32.3: Cancel Restores Original

STEPS (continued from T32.2):

Make a change in the textarea
Click Cancel EXPECT:

Original message text restored exactly
No messages sent, no API call FAIL: Original text lost, message sent.

T32.4: Escape Also Cancels

STEPS:

Enter edit mode on a user message
Press Escape EXPECT:

Textarea dismissed, original restored FAIL: Escape does nothing.

T32.5: Send Edit Truncates and Regenerates

STEPS:

Click edit on a user message that has a response after it
Change the text
Click "Send edit" (or press Enter) EXPECT:

All messages after the edited message are removed
The edited text is sent as a new user message
Hermes streams a fresh response FAIL: Old messages remain, double messages, crash.

Section 33: Regenerate Last Response (Sprint 8)

T33.1: Retry Icon on Last Assistant Bubble Only

SETUP: Session with at least one complete exchange. EXPECT:

A retry (↻) icon appears on hover over the LAST assistant message only
Not on user messages
Not on older assistant messages FAIL: Icon on every message, or not on last.

T33.2: Regenerate Re-Runs Last User Message

STEPS:

Hover the last assistant bubble and click the retry icon EXPECT:

The last assistant message is removed
The previous user message is re-sent
Hermes streams a new response FAIL: Both messages removed, wrong message sent, crash.

Section 34: Clear Conversation (Sprint 8)

T34.1: Clear Button Appears When Session Has Messages

SETUP: Session with at least one message. EXPECT:

A "🗑 Clear" chip appears in the topbar right side (next to the workspace chip)
Button NOT visible when session has no messages / empty state FAIL: Button always visible, never visible.

T34.2: Clear Wipes Messages and Resets Title

STEPS:

Click the Clear button in the topbar
Confirm the dialog EXPECT:

All messages disappear from the chat area
Empty state ("What can I help with?") reappears
Session title in sidebar resets to "Untitled"
Toast: "Conversation cleared"
Session still in the sidebar (not deleted) FAIL: Session deleted, messages remain, title not reset.

T34.3: Cancel Clear Does Nothing

STEPS:

Click Clear, then click Cancel in the confirm dialog EXPECT:

All messages still present
No toast, no change FAIL: Messages cleared despite cancel.

Section 35: Syntax Highlighting (Sprint 8)

T35.1: Code Blocks Have Syntax Colors

SETUP: Ask Hermes something that produces a code response (e.g. "Show me a Python hello world"). EXPECT:

The code block has syntax-colored tokens (keywords in one color, strings in another)
NOT all plain white/gray monospace text
Dark background with Prism Tomorrow theme colors FAIL: All plain text, no colors, broken layout.

T35.2: Code in Workspace Preview Also Highlighted

SETUP: Open a .py or .js file in the workspace panel. EXPECT:

File content has syntax highlighting (Prism autoloader) FAIL: Plain monospace text only.

Automated Test Coverage (Updated Sprint 8)

Sprint 8 tests (test_sprint8.py) - 14 tests:

session/clear: requires session_id, unknown 404, wipes messages+resets title, returns compact
session/truncate: requires session_id, requires keep_count, unknown 404, returns messages array
Static file checks: app.js has editMessage, regenerateResponse, clearConversation, highlightCode
index.html: contains Prism CDN link, contains btnClearConv + clearConversation

Total automated: 139/139 passing.

Manual-only for Sprint 8:

T32.1-T32.5: edit message UX
T33.1-T33.2: regenerate UX
T34.1-T34.3: clear conversation UX
T35.1-T35.2: syntax highlighting visual

Last updated: Sprint 10 complete, March 31, 2026 Total automated tests: 177/177 Regression gate: tests/test_regressions.py (10 tests, one per introduced bug) Run: python -m pytest tests/ -v Source: / Modules: ui.js, workspace.js, sessions.js, messages.js, panels.js, boot.js (app.js deleted)

Section 36: Message Queue (Sprint 8 hotfix)

T36.1: Typing While Busy Queues the Message

SETUP: Active session, a response is currently streaming (thinking dots visible). STEPS:

While Hermes is responding, type a new message and press Enter EXPECT:

Input clears immediately
A small toast appears: "Queued: [your message]"
A badge appears in the bottom-right: "1 message queued"
The current response continues uninterrupted FAIL: Message dropped silently, duplicate send triggered, error.

T36.2: Queued Message Sends Automatically After Response

STEPS (continued from T36.1):

Wait for the current response to finish EXPECT:

As soon as the response completes, the queued message is automatically sent
Badge disappears
New thinking dots appear for the queued message FAIL: Queued message never sends, badge stays, double-send.

T36.3: Queue Badge Shows Count for Multiple Messages

STEPS:

While busy, type and send two separate messages EXPECT:

Badge reads "2 messages queued"
They drain one at a time, each waiting for the previous response FAIL: Only first message queued, count wrong.

T36.4: Switch Session Clears Queue

STEPS:

Queue a message in session A
Click to session B before it drains EXPECT:

Queue badge disappears
The queued message does NOT fire in session B FAIL: Queued message fires in session B.

Section 37: Message Persists on Switch-Away (Sprint 8 hotfix)

T37.1: Sent Message Stays Visible After Switch-Away and Back

SETUP: Active session. STEPS:

Send a message (thinking dots appear)
Immediately click to a different session
Click back to the original session EXPECT:

The user message you sent is still visible in the chat
Thinking dots are still animating
Session is still in busy state (Send button disabled)
When response arrives, it appears normally FAIL: User message gone, blank chat, response lands in wrong session.

Sections Added Post-Sprint 10 (Sprints 11-19)

The following features were added in Sprints 11-19 and need manual browser testing. Each has automated API-level tests in tests/test_sprint{N}.py.

Sprint 11: Multi-Provider Models

Open model dropdown. Verify models grouped by provider (OpenAI, Anthropic, Google, etc.)
If custom base_url configured in config.yaml, verify local models appear in dropdown.
Switch model. Send a message. Verify response uses selected model.

Sprint 12: Settings + Pin + Import

Click gear icon. Settings overlay opens.
Change default model, save. Restart server. Verify setting persisted.
Pin a session (star icon in hover overlay). Verify it floats to top of list.
Export session as JSON. Import it back. Verify messages restored.

Sprint 13: Alerts + Session QoL

Duplicate a session (copy icon in hover overlay). Verify "(copy)" title.
Browser tab title updates to active session name. Switch sessions — title changes.

Sprint 14: Visual Polish + Workspace Ops

Create a mermaid code block in a response. Verify diagram renders inline.
Message timestamps visible next to role labels (hover for full date).
Double-click a file in workspace panel to rename. Enter saves, Escape cancels.
Create a folder via folder icon in workspace header.
Add #tag to session title. Verify tag chip appears in sidebar. Click to filter.
Archive a session. Verify it disappears. Toggle "Show archived" to see it.

Sprint 15: Session Projects

Click "+" in project bar to create a project. Type name, Enter.
Click a project chip to filter sessions.
Hover a session → click folder icon → assign to project via picker.
Verify colored left border appears on assigned session.
Double-click project chip to rename. Right-click to delete.
Code blocks have a "Copy" button. Click → "Copied!" feedback.
Messages with 2+ tool cards show "Expand all / Collapse all" toggle.

Sprint 16: Sidebar Visual Polish

Session titles use full sidebar width (no truncated space for hidden icons).
Hover a session → action buttons appear from right with gradient fade.
All icons are monochrome SVGs (not emoji). Consistent across platforms.
Pinned sessions show small gold star inline. Unpinned = no star, full title width.
Active session has gold highlight (not blue). Overlay gradient matches.
Double-click to rename → overlay hides during rename.

Sprint 17: Workspace + Slash Commands + Send Key

Navigate into a subdirectory. Breadcrumb bar appears with clickable segments.
Up button in panel header navigates to parent. Hidden at root.
Type / in composer → autocomplete dropdown appears. Arrow keys navigate.
Type /help → lists all commands. /clear clears conversation. /model switches.
Settings panel: change send key to Ctrl+Enter. Verify Enter inserts newline.

Sprint 18: Thinking + Tree View + Preview Fix

View a file in workspace. Click a breadcrumb or folder → preview closes automatically.
Click a directory toggle arrow (▸) → expands in-place showing children.
Click again (▾) → collapses. Double-click navigates into it (breadcrumb view).
If model returns thinking blocks (Claude extended thinking), verify collapsible gold card appears above response.

Sprint 19: Auth + Security

No password set: everything works as normal. No login page.
Set HERMES_WEBUI_PASSWORD=test env var. Restart. All pages redirect to /login.
Login page: minimal card, password field, "Sign in" button.
Enter correct password → redirected to /. Cookie set (24h).
Enter wrong password → error message, stay on login page.
Settings panel: set password via "Access Password" field. Auth activates.
"Sign Out" button visible when auth active. Click → redirected to /login.
API calls without auth cookie → 401 JSON response.
Check response headers: X-Content-Type-Options: nosniff, X-Frame-Options: DENY.

Sprint 20: Voice Input + Send Button

Mic button visible in composer (Chrome/Edge). Hidden in Firefox.
Tap mic → button turns red with pulse, "Listening..." indicator appears.
Speak → live transcription appears in textarea.
Stop speaking → auto-stops after ~2s silence. Text stays editable.
Tap mic again or Send → stops recording, sends text.
Type text, then tap mic → spoken text appends to existing text (doesn't replace).
Send button hidden when textarea is empty. Appears with pop-in animation when typing.
Send button is icon-only circle (no "Send" text label). Blue with glow.
Attach a file with no text → send button appears.
Send message → button disappears after textarea clears.
While agent is responding → send button hidden.

Sprint 21: Mobile Responsive + Docker

Open on mobile viewport (<640px): hamburger icon visible in topbar.
Tap hamburger → sidebar slides in from left with backdrop overlay.
Tap outside sidebar → closes. Tap a session → closes and loads session.
Bottom navigation bar: 5 tabs (Chat, Tasks, Skills, Memory, Spaces).
Tap "Tasks" in bottom nav → sidebar opens showing Tasks panel.
Tap "Chat" in bottom nav → sidebar closes (chat is in main area).
Files button in topbar → right panel slides in from right.
All touch targets are at least 44px (session items, buttons, icons).
Desktop viewport (>640px): no hamburger, no bottom nav, no mobile elements.
Docker: docker compose up -d starts server on port 8787.
Docker: session data persists across container restarts (named volume).

Sprint 22: Multi-Profile Support

Profile chip in topbar (purple accent). Click → dropdown with all profiles.
Dropdown shows gateway status dots, model info, skill count per profile.
Click a profile → switches; model dropdown, skills, memory, cron refresh.
"Manage profiles" link opens Profiles sidebar panel.
Profiles panel: cards with name, model, provider, skill count, API key status.
"Use" button switches profile. Delete button removes non-default profiles.
"+ New profile" form: name validation (lowercase + hyphens), clone config checkbox.
Create profile → appears in list and dropdown.
Delete profile → confirm dialog. Auto-switches to default if deleting active.
Attempt switch while agent busy → blocked with toast message.
With hermes-agent not installed → only default profile shown, graceful fallback.

Last updated: v0.47.0, April 11, 2026 Total automated tests: 645 (645 passing, 0 failures) Regression gate: tests/test_regressions.py Run: pytest tests/ -v --timeout=60 Source: /

60 KiB Raw Blame History

Hermes Web UI: Browser Testing Plan

How to Use This Document

Section 1: Initial Load and Empty State

T1.1: Fresh Load Shows Empty State

T1.2: Suggestion Buttons Work

Section 2: Session Management

T2.1: Create New Session via + Button

T2.2: Send a Message and See Response

T2.3: Shift+Enter Creates Newline (Does Not Send)

T2.4: Reload Restores Session

T2.5: Delete Active Session

T2.6: Delete Non-Active Session

T2.7: Delete Last Session Shows Empty State

Section 3: Model Selection

T3.1: Model Dropdown Shows All Options

T3.2: Model Chip Reflects Selection

Section 4: File Upload

T4.1: Click-to-Attach Opens File Picker

T4.2: Attach a Text File and Send

T4.3: Drag and Drop a File

T4.4: Paste Screenshot from Clipboard

T4.5: Remove a File from Tray

Section 5: Workspace File Browser

T5.1: File Tree Loads on Session Start

T5.2: Navigate Into a Directory

T5.3: Preview a Code File

T5.4: Close Preview Returns to File Tree

T5.5: Preview an Image File (Sprint 2)

T5.6: Preview a Markdown File (Sprint 2)

T5.7: Markdown Preview Renders Tables (Sprint 2)

T5.8: Refresh Files Button

Section 6: Workspace Path

T6.1: Change Workspace Path

Section 7: Tool Approval

T7.1: Dangerous Command Shows Approval Card

T7.2: Deny Approval Blocks the Command

T7.3: Allow Once Executes the Command

Section 8: Transcript Download

T8.1: Download Conversation as Markdown

user

assistant

Section 9: Reconnect Banner (Sprint 1 - B4/B5)

T9.1: Reconnect Banner After Mid-Stream Reload

Section 10: Multi-Session and Concurrent Behavior

T10.1: Switch Sessions While Response Is Loading

T10.2: Multiple Sessions in List (Up to 30)

Section 11: Visual and Layout Checks

T11.1: Right Panel Hidden on Small Screens

T11.2: Sidebar Hidden on Very Small Screens

T11.3: Structured Log Output

Section 12: Error Handling

T12.1: Send Button Disabled When Busy

T12.2: Upload Failure Shows Status

T12.3: File Preview for Binary Non-Image

Automated Test Coverage Reference

Claude Browser Agent Instructions

Section 13: Sidebar Panel Navigation (Sprint 3)

T13.1: Four Tabs Visible in Sidebar

T13.2: Tab Switching Preserves Chat State

Section 14: Tasks Panel (Cron Viewer) (Sprint 3)

T14.1: Tasks Tab Shows Cron Jobs

T14.2: Expand a Job Row

T14.3: Pause and Resume a Job

T14.4: Last Output Shows Real Content

Section 15: Skills Panel (Sprint 3)

T15.1: Skills Tab Shows Categorized List

T15.2: Search Filters Skills

T15.3: Click Skill Opens SKILL.md in Right Panel

Section 16: Memory Panel (Sprint 3)

T16.1: Memory Tab Shows Personal Notes

T16.2: Memory Content is Accurate

Section 17: Bug Fix Verification (Sprint 3)

T17.1: B6 - New Session Inherits Workspace

T17.2: B10 - Tool Events Replace Thinking Dots

T17.3: B14 - Cmd/Ctrl+K Creates New Chat

Automated Test Coverage (Updated Sprint 3)

Section 18: Source Relocation Verification (Sprint 4)

T18.1: UI Loads and CSS Renders Correctly After Relocation

Section 19: Session Rename (Sprint 4)

60 KiB

Raw Blame History