Settings

Accessing settings

In the TUI, press Shift+S from any screen to open Settings. Or use:

merka settings

Add --json for machine-readable output.

Available settings

Theme

Switch between Light and Dark mode. The theme affects all TUI screens. The system default follows your terminal’s color scheme.

Log level

Control how much detail appears in log files:

Level	What it captures
error	Only errors
warn	Errors and warnings
info	Normal operation (default)
debug	Detailed debugging information
trace	Everything, including low-level details

You can also set the log level at launch:

merka --log-level debug

Or via environment variable:

MERKA_LOG=debug merka

Identity actions

From the Settings screen you can access identity management actions:

• View identity — Shows your device fingerprint and link state
• Link to cosmic.rocks — Connect to a cosmic.rocks account
• Unlink — Remove the cosmic.rocks connection
• Rotate device key — Generate a new device-signing key (keeps your identity)

Log files

Log files are written to:

# macOS
~/Library/Logs/rocks.cosmic.merka.cli/

# Linux
~/.local/state/rocks.cosmic.merka.cli/

When reporting issues, include these logs in your support bundle (merka diagnostics export).

Environment variables

Variable	Effect
MERKA_LOG	Set log level (same as --log-level)
MERKA_HOME	Override the data/cache/log directory root