Skip to content

[Feature]: TinyOffice: add first-run web onboarding for initial setup #193

@mczabca-boop

Description

@mczabca-boop

Component

Agent execution

Problem or Motivation

Problem

TinyOffice is currently useful once TinyClaw is already configured, but it is not yet a good first-run setup experience.

Right now, initial setup still depends heavily on CLI flows and raw config editing. This makes TinyOffice feel like an operator dashboard rather than the main product entrypoint.

Proposal

Add a first-run onboarding flow in TinyOffice that guides the user through initial configuration step by step.

Suggested flow:

  1. Choose AI provider
  2. Configure model
  3. Configure workspace/default agent
  4. Enable channels
  5. Set heartbeat interval
  6. Review and save
  7. Run validation and show next steps

Why this matters

If the goal is to move setup into TinyOffice, users should not need to understand settings.json or use terminal setup commands for common cases.

Suggested UX

  • Show onboarding automatically when config is incomplete
  • Keep advanced settings hidden behind an "Advanced" section
  • Validate fields inline
  • Show a final confirmation screen before applying changes

Notes

Current TinyOffice Settings page is useful for advanced users, but not a good first-run experience.

Proposed Solution

Add a first-run onboarding flow in TinyOffice that guides the user through initial configuration step by step.

Alternatives Considered

No response

Additional Context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions