Configure Application

Configure global CLI settings and preferences interactively.

Bash

zeysdk configure

Available Settings

Setting	Description	Default
Default Diff Tool	Choose comparison tool for file diffs	Platform dependent
List Height	Number of items shown in selection lists	10
Run Output Style	Default output format for zeysdk run (Pretty or Simple)	Pretty
Credential Storage	Select credential backend (Auto, OS Keyring, File Store)	Auto

Diff Tools by Platform

Windows

• Beyond Compare
• WinMerge
• VSCode
• Other (custom path)
• None

macOS

• Beyond Compare
• FileMerge
• VSCode
• Other (custom path)
• None

Linux

• Beyond Compare
• Meld
• VSCode
• Other (custom path)
• None

Configuration Storage

Settings are stored in the selected credential backend:

• Auto: Uses OS keyring on supported desktop systems, otherwise file store
• OS Keyring: Uses platform keychain when available (encrypted)
• File Store: Stores credentials in ~/.config/zeysdk/store.json (unencrypted)

Environment variables (ZEYSDK_USE_KEYRING or legacy ZEYSDK_USE_KEYTAR) override configured storage mode.

Error Handling

Error	Description	Resolution
Storage access	Failed to access configured credential backend	Check keychain availability or switch to File Store
Invalid input	Invalid list height value	Enter a positive number
Save failed	Failed to save configuration	Verify write permissions