Skip to content

0.9.1: standalone-start UX — readable log + obvious 'open this URL' banner #39

@raffelino

Description

@raffelino

After installing from a Release Package and running start-windows.bat (or the mac/linux equivalent), the terminal experience is rough:

  1. Log output is JSON (pythonjsonlogger.JsonFormatter). Right for log shippers, hostile for a fresh user staring at a cmd window.
  2. The URL the user needs (http://localhost:8145) is just a stray uvicorn INFO line buried in the JSON wall — you have to read the README or the bundled dist-README.md to know where to point your browser.

Proposed fix (target 0.9.1)

  • LOG_FORMAT=text env var that flips main.py's formatter to readable LEVEL logger: message form. Default off → Docker / make dev keeps JSON for log-shipper ingestion.

  • After uvicorn reports ready, print a clearly-set-off banner:

    ════════════════════════════════════════════════
    ✓  RoboScope is running
       Open in your browser:  http://localhost:8145
    ════════════════════════════════════════════════
    

    Respects the PORT env var so a custom port shows the right URL.

  • Optional OPEN_BROWSER=1 flag to auto-webbrowser.open() after readiness, default off so headless installs don't break.

  • ASCII-safe fallback when running on Windows with a legacy code page (avoids mojibake).

Full story spec + acceptance criteria: _bmad-output/implementation-artifacts/launch-1-windows-terminal-ux.md.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions