Skip to content

[FEATURE]: Custom home screen logo (slot or setting; V1 home_logo has no V2 equivalent) #51916

Open

Description

@Qodevv

Feature hasn't been suggested before.

  • I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

Summary

V1 CLI plugins could replace the home screen logo through the home_logo slot. In V2 there is no logo slot, no logo setting, and the home logo is hardcoded, so the built-in logo can be neither replaced, customized, nor hidden through any supported path.

Environment

  • opencode version: 2.0.18
  • OS: Linux archlinux 7.2.6-arch2-1 x86_64 GNU/Linux
  • Terminal: xterm-256color, truecolor
  • Shell: /usr/bin/bash
  • Install/channel: release, local install (~/.opencode/bin/opencode)
  • Active plugins: one local V2 CLI plugin (Plugin.define from @opencode/plugin/tui) rendering a custom logo into home.footer (used to probe the available slots)

Reproduction

  1. Write a V2 CLI plugin with Plugin.define from @opencode/plugin/tui that renders a custom logo.
  2. Try to place it where the home logo is: no home.logo (or similar) slot exists — only app, home.footer, home.footer.status, prompt.*, session.*, sidebar.*.
  3. Try "logo": "..." in cli.json → rejected as an unknown setting.
  4. Launch opencode: the built-in logo always renders on top; a custom logo can only live somewhere else (e.g. home.footer, below the input box).

Expected Behavior

One easy, supported customization point — whichever is simplest for the maintainers: a home.logo slot with replace support (V1 parity), or a minimal logo setting accepting a file path or false, as previously proposed in #12016.

Actual Behavior

Neither exists. Logo customizations built on the V1 home_logo slot silently stop working after migrating to V2.

Additional Context

  • Verified against the V2 CLI plugin reference, the CLI settings reference (every setting documented; unknown settings rejected), and the 2.0.18 binary (no logo slot present).
  • Related: Feature Request: Custom Logo Configuration #12016 (closed discussion requesting the same capability).
  • Consistent, not intermittent. No workaround replaces the home logo.

Activity

  1. github-actions commented on Sep 28, 2026

    @github-actions
    Contributor

    This issue doesn’t fully meet our contributing guidelines.

    What needs to be fixed:

    • This requests a new customization capability, so please use the Feature Request format: start the title with [FEATURE]: and include the required verification checkbox confirming you checked whether the feature has already been suggested.

    Please edit this issue to address the above within 2 hours, or it will be automatically closed.


    This issue might be a duplicate of existing issues. Please check:

    If you believe this was flagged incorrectly, please let a maintainer know.

  2. changed the title [-]tui: no supported way to customize the home screen logo (V1 home_logo slot has no V2 equivalent)[/-] [+][FEATURE]: Custom home screen logo (slot or setting; V1 home_logo has no V2 equivalent)[/+] on Sep 28, 2026
  3. github-actions commented on Sep 28, 2026

    @github-actions
    Contributor

    Thanks for updating this issue with the Feature Request details, reproduction steps, and system information!

  4. pranavsreedhar123 commented on Oct 9, 2026

    @pranavsreedhar123

    Hi @simonklee, following up on this request. I’ve prepared a V2 home.logo replacement slot to restore the customization previously available through V1’s home_logo, following the approach you described in #33691. I’d also like to include an independent stats.logo slot so plugins can replace or hide the logo on /stats. Both reuse the existing slot system and preserve the built-in content when no replacement is registered. The implementation is on my fork - commit, with focused tests and the full repository check passing.
    Would you approve opening a PR against v2 that closes this issue and includes both slots, or would you prefer stats.logo handled separately?

  5. opencodejr commented on Oct 28, 2026

    @opencodejr
    Contributor

    Thanks for the detailed request, @Qodevv!

    To restate it: you'd like a supported way to replace, customize or hide the v2 home screen logo. That could be a home.logo plugin slot that supports replace, like the v1 home_logo slot, or a simple logo setting that takes a file path or false.

    You're right that v2 doesn't offer this today. The home route renders the built-in logo directly, without a slot around it, and the plugin slot map only exposes home.footer and home.footer.status on the home screen. That means a plugin can't replace just the logo yet. Adding a home.logo slot to the plugin API would make it possible, and this is the specific change I've suggested to the maintainers.

    Related:

    Maintainers will consider this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

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