Suduxu
CLI

Config Commands

Manage, import, export, inspect, and reset Suduxu configuration files.

The config command group is used to manage the local suduxu.json configuration used by Suduxu.

Configuration files control networking, security, themes, screenshots, logging, and other runtime behavior. See the Configuration Reference for a complete breakdown of all available settings.

Show Current Configuration

Display the currently active configuration.

suduxu config show

This prints the entire configuration to the terminal.


Import a Configuration

Replace the current configuration with a configuration file.

suduxu config import my-config.json

After importing, the selected file becomes the active Suduxu configuration.

Importing a configuration replaces the currently active configuration.


Export a Configuration

Export the current configuration to a file.

suduxu config export backup.json

This creates a portable configuration file that can be shared or stored as a backup.

Export Behavior

When exporting a configuration, Suduxu automatically adjusts a few settings to make the exported file safe for distribution:

  • prefer_cli is set to false
  • Mocked inputs are disabled

This prevents environment-specific settings from being unintentionally shared.


Reset Configuration

Restore the default Suduxu configuration.

suduxu config reset

This recreates the configuration using Suduxu's default values.

Any custom configuration changes will be lost after a reset.


Clear Configuration

Delete the active configuration entirely.

suduxu config clear

The configuration file is removed from the system.

This command deletes the configuration file. Suduxu may recreate it with default values during the next startup depending on your environment.


Common Workflows

Create a backup of the current configuration.

suduxu config export backup.json

Restore a previously exported configuration.

suduxu config import backup.json

Reset everything back to defaults.

suduxu config reset

On this page