Skip to content

P2: First-launch tutorial (tutorial plugin + auto-query) and a --query launch parameter #44

Open

Description

@Mechazawa

Priority: P2

Two related pieces of launch and onboarding behavior.

  1. First-launch tutorial view.
  • Ship a bundled tutorial plugin that renders a view (see docs/views.md) with getting-started information.
  • On first launch, show it automatically by running a preset query, so the tutorial view appears without the user typing anything. Reuse the existing first-launch detection used to seed bundled plugins (src/bundle_install.rs, src/daemon.rs).
  • Do not show it again on later launches.
  1. --query launch parameter, which the tutorial builds on.
  • Add a --query <text> flag to the CLI (src/cli.rs, next to --open and --once).
  • Forward it to a running daemon over IPC by extending the Command enum (src/ipc.rs:16) additively. The wire format is documented as stable, so add a new variant or payload rather than changing open.
  • On open, pre-fill the query box with the text so results or a view appear right away.
  • Implement the tutorial as a launch with a preset query that the tutorial plugin answers.

Done when:

  • highbeam --query "…" opens the launcher with that query filled in, both on a cold start and forwarded to a running daemon.
  • A bundled tutorial plugin shows its view automatically on first launch only.

Activity

  1. added this to the v1.0.0 milestone on Jun 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions