Skip to content

[FEATURE]: add interactive /settings command for editing opencode.json #32988

Closed as not planned

Description

@Razaib-khan

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

Feature Request

Summary

Add a /settings command to the TUI that provides an interactive interface for viewing and modifying opencode.json without manually editing JSON files.

Problem

Currently, configuring OpenCode often requires:

  • Finding the correct opencode.json location
  • Looking up valid configuration keys and values
  • Manually editing JSON
  • Restarting OpenCode to apply changes

This creates friction, especially for new users and users who frequently adjust settings.

Proposed Solution

Introduce a /settings command that opens an interactive TUI menu.

Features could include:

  • Browse all supported configuration categories
  • View current values
  • Edit settings through prompts, toggles, selectors, and input fields
  • Validate values before saving
  • Display descriptions/help text for each setting
  • Create opencode.json automatically if it does not exist
  • Preview changes before applying them
  • Confirm changes before writing to disk

Example Flow

/settings

> Models
> Providers
> MCP Servers
> Permissions
> Appearance
> Advanced

Select setting → Modify value → Review changes → Confirm

Session Reload

After saving:

  1. Write changes to opencode.json
  2. Gracefully restart/reload the current OpenCode session
  3. Return the user to the same terminal instance

This ensures configuration changes take effect immediately without requiring users to manually exit and relaunch OpenCode.

Benefits

  • Better onboarding experience
  • Reduced configuration errors
  • Faster discovery of available settings
  • Less time spent searching documentation for valid JSON keys
  • More consistent and user-friendly configuration workflow
  • Immediate feedback through automatic session reload

Additional Considerations

  • Generate the menu dynamically from the configuration schema to avoid duplication and keep the UI synchronized with supported settings.
  • Show default values and descriptions where available.
  • Warn users when a setting requires a full restart or may impact active sessions.

Activity

  1. github-actions commented on Jun 19, 2026

    @github-actions
    Contributor

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

  2. Razaib-khan commented on Jun 19, 2026

    @Razaib-khan
    Author

    No The issue #32988 created by me isn't the duplicate of any of these issues mentioned by the github-actions bot.

  3. github-actions commented on Aug 19, 2026

    @github-actions
    Contributor

    To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.

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