config.example.json

{
  "//": "Copy to ~/.fire/config.json. Every field is optional; omitted fields keep their defaults.",

  "engine": {
    "//": "Raise DECAY_BASE or POISON_RATE to make it crueller. Raise CLIMB_RATE to make the top reachable.",
    "CLIMB_RATE": 0.35,
    "DECAY_BASE": 0.02,
    "DECAY_SCALE": 157,
    "STARVE_RAMP": 5.0,
    "STARVE_FULL": 600,
    "POISON_RATE": 0.5,
    "IDLE_SOFT": 45,
    "IDLE_DEAD": 120,
    "TARGET_EPM": 240
  },

  "punish": {
    "//": "gutter/warn/shame are always on. block and lock touch the OS.",
    "block": false,
    "lock": false
  },

  "nuclear": {
    "//": "OS SHUTDOWN. Requires BOTH enabled:true AND the exact consent phrase.",
    "//2": "Consent phrase: I ACCEPT THE LOSS OF UNSAVED WORK",
    "//3": "Also requires punish.lock:true -- shutdown may not outrank a rung you disabled.",
    "enabled": false,
    "consent": "",
    "countdownSec": 60,
    "minUptimeSec": 120
  },

  "pet": {
    "//": "The fire is a desktop pet: a transparent, always-on-top flame with no window chrome.",
    "size": 300,
    "corner": "bottom-right",
    "margin": 16,
    "clickThrough": true,
    "allWorkspaces": true,
    "onTop": true
  },

  "window": {
    "//": "mode 'pet' = desktop pet (default). 'window' = a framed debug window.",
    "mode": "pet"
  },

  "theme": {
    "//": "The look of the fire. All defaults are identity. Easier via the tray's 'Customize…' panel, but every field is editable here; out-of-range values are clamped on load.",
    "hueShift": 0,
    "//hueCycle": "Living colour: the hue slowly drifts over time. 0 = fixed.",
    "hueCycle": 0,
    "saturation": 1,
    "brightness": 1,
    "//effects": "Eye candy. 0 = the original fire. embers = rising sparks; bloom = extra glow + god-rays + stellar flare.",
    "embers": 0.7,
    "bloom": 0.6,
    "paletteMix": 0,
    "//palette": "Custom base->mid->tip gradient, only visible when paletteMix > 0.",
    "palette": { "base": "#ff2d00", "mid": "#ff9d00", "tip": "#fff1c2" },
    "speed": 1,
    "turbulence": 1,
    "//size": "Master on-screen scale (zoom about centre). Lower it to stop the big cosmic tiers from filling the screen.",
    "size": 1,
    "widthScale": 1,
    "heightScale": 1,
    "swirl": 0,
    "//spin3d": "0..1 pseudo-3D rotating textured column; rotation speed follows 'speed'.",
    "spin3d": 0,
    "//scene": "'fire' (default) or 'voxel' (pixelated 3D rotating figures).",
    "scene": "fire",
    "//figure": "voxel figure: flame | cube | sphere | torus | figure | knot | obsidian | space | crystal | plasma | helix | galaxy.",
    "figure": "flame",
    "//pixelate": "0..1 chunky pixel blocks; works on both scenes, strongest in voxel.",
    "pixelate": 0
  },

  "//progression": "How the LOOK paces the 2600-stage climb. Identity by default (fire unchanged). Only the visuals are reshaped; stages/epochs/gameplay use the raw value. model: identity | ease | logistic | gompertz | richards | bezier. Easier via the tray 'Progression' menu; the curve is clamped monotone + endpoint-pinned on load.",
  "progression": {
    "enabled": false,
    "global": { "model": "identity", "rate": 1, "midpoint": 0.5, "nu": 1, "lag": 0, "power": 3 }
  },

  "//trackers": "Small widgets shown in the ticker under the fire. Easier via the tray's 'Trackers' menu; out-of-range values are clamped and bad entries dropped on load. type: counter | text | countdown | stopwatch.",
  "trackers": [
    { "type": "counter", "label": "Days since incident", "value": 0, "step": 1 },
    { "type": "text", "label": "Focus", "text": "the one thing today" },
    { "type": "countdown", "label": "Pomodoro", "durationSec": 1500 },
    { "type": "stopwatch", "label": "On task" }
  ],

  "//autostart": "Launch the pet automatically at login (also toggleable from the tray).",
  "autostart": false,

  "rules": [
    { "class": "POISON", "title": "hacker ?news", "why": "HN" },
    { "class": "FUEL", "title": "reddit\\.com/r/rust", "why": "research" }
  ]
}