Skip to content

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

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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions