Skip to content

docs: capture remaining 0.24.0 screenshots that need a live environment (approval prompt, first-chat, channel resolution) #71

Description

@Aaronontheweb

A handful of 0.24.0 screenshots can't be captured with the hermetic VHS + Docker rig used for the init/config refresh (#69, #70) — they need a live model and/or a real channel workspace with tokens. Tracking the specific gaps here so anyone with that environment can knock them out. Everything else (5-step init, config dashboard + all sub-area editors, existing-install menu/reset) is already captured and shipped.

1. Tool-approval prompt — current 5-button UI

  • File: public/assets/approval-prompt.png (refresh in place)
  • Used by: channels/slack.md (the "Tool approval" section)
  • Current: stale 4-button prompt — Approve once / Approve for this chat / Approve always / Deny.
  • Needed: the current 5-button prompt — Once / This chat / Always here / Always anywhere / Deny (0.24.0 split the old "Always" into here/anywhere).
  • How: a real Slack workspace with netclaw connected, then a live agent proposing a restricted tool (e.g. shell_execute) so the interactive approval message renders in-thread.
  • Bonus: a Discord and/or Mattermost equivalent — both post button approvals (Mattermost only when CallbackUrl is set), and those pages currently have no approval visual.

2. First-chat TUI

  • File: screenshots/output/chat-session-start.png (the only remaining <!-- TODO(screenshots) --> in the docs)
  • Used by: getting-started/quickstart.md ("First chat session")
  • Needed: the chat TUI right after netclaw init auto-launches, showing the agent's intro / personality-bootstrapping question.
  • How: a real provider/model — the qwen2:0.5b capture model doesn't produce a representative session. (A stale May-2025 image exists at this path; it should be overwritten.)

3. Channel resolve-before-add, in action

  • File: screenshots/output/config-channels-resolve.png (new)
  • Used by: cli/config.md (Channels section) — and would enrich the channel pages.
  • Needed: the add-channel flow where a typed channel name resolves to a canonical ID (ideally also the rejection of an unresolvable name).
  • How: a real Slack/Discord/Mattermost bot token so the resolution probe hits the live platform API.

4. (Optional) Personal-posture wizard counter

  • Used by: getting-started/quickstart.md (Personal is the primary audience)
  • Current: the embedded wizard shots are a Team/Public run (Step X of 5); the prose already notes Personal is 4 steps.
  • Needed (if desired): a Personal-posture run so the counter reads Step X of 4. These would be new filenames — the current init-01/02/05-* files are shared with cli/init.md, which documents the full 5-step flow (incl. the Team-only Enabled Features step).

Capture pipeline: new TUI shots go through screenshots/tapes/*.tapescreenshots/output/ (source of truth; npm run copy-screenshots rsyncs to public/). The reusable keystroke flows live in netclaw-dev/netclaw under tests/smoke/tapes/. The approval/chat shots, however, need a real session rather than a tape.

Follow-up to #69 / #70 (epic #55, the post-#1368 screenshot campaign).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions