Configuration

CliDeck is configured through the Settings panel in the UI. Settings are stored in ~/.clideck/config.json. You rarely need to edit config.json directly — the Settings UI covers everything. This page documents all available options for reference.

​

Command-Line Flags

Use --host 0.0.0.0 to make CliDeck accessible from other devices on your network (LAN, Wireguard, etc.), or --host <ip> to bind to a specific interface. Running --host without a value defaults to 0.0.0.0.

​

General Settings

​

CLI Agent Settings

Each agent in the command list has these properties:

​

Notification Settings

​

Appearance Settings

​

Projects

Projects are stored in the config as an array:

​

Data Directory

All CliDeck data lives in ~/.clideck/: This directory is created automatically on first run. It’s separate from the CliDeck installation, so your data is preserved when you update CliDeck.

​

Migrations

CliDeck automatically migrates your config when the format changes between versions. Old settings are preserved — you won’t lose your configuration when updating.

​

Agent Presets

Built-in agent definitions are stored in agent-presets.json. These provide defaults for each supported agent (command, icon, resume command, telemetry settings, etc.). When CliDeck loads, it syncs your configured agents with the latest preset data — ensuring you always get updated icons, resume commands, and telemetry configurations.