CELL-CONFIG(1)

NAME
cell config - manage system and actor configurations

SYNOPSIS
cell config command [options]

DESCRIPTION
The cell config command manages configuration settings for the Cell system. It provides functionality to view, set, and manage both system-wide and actor-specific configuration values stored in .cell/cell.toml.

COMMANDS

get key
    Get a configuration value. Keys use dot notation (e.g., system.ar_timer).

set key value
    Set a configuration value. Values are automatically parsed to appropriate types.

list
    List all configuration values in a hierarchical format.

actor name get key
    Get an actor-specific configuration value.

actor name set key value
    Set an actor-specific configuration value.

actor name list
    List all configuration values for a specific actor.

SYSTEM KEYS

system.ar_timer
    Seconds before idle actor reclamation (default: 60)

system.actor_memory
    MB of memory an actor can use; 0 for unbounded (default: 0)

system.net_service
    Seconds per network service pull (default: 0.1)

system.reply_timeout
    Seconds to hold callback for reply messages; 0 for unbounded (default: 60)

system.actor_max
    Maximum number of simultaneous actors (default: 10,000)

system.stack_max
    MB of memory each actor's stack can grow to (default: 0)

EXAMPLES
View a system configuration value:

cell config get system.ar_timer

Set a system configuration value:

cell config set system.net_service 0.2

Configure an actor-specific setting:

cell config actor prosperon/_sdl_video set resolution 1920x1080
cell config actor extramath/spline set precision high

List all configurations:

cell config list

List actor-specific configurations:

cell config actor prosperon/_sdl_video list

FILES

.cell/cell.toml
    The main configuration file containing all system and actor settings.

NOTES
Configuration values are automatically parsed to appropriate types:

•   Boolean: true, false

•   Numbers: integers and floats (underscores allowed for readability)

•   Strings: everything else

Actor configurations are loaded automatically when an actor starts, merging the actor-specific settings into the actor's args.

SEE ALSO
cell(1), cell-init(1), cell-get(1)