tinysocs-config-and-flags

Documents every TinySocs config file, environment variable, and default across the C# agent and Python services.

Updated Oct 12, 2025
One-click install
npx skills add https://github.com/lukefitzg/tinysocs --skill tinysocs-config-and-flags-lukefitzg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tinysocs-config-and-flags
Source: https://github.com/lukefitzg/tinysocs/tree/main/.claude/skills/tinysocs-config-and-flags
Command: npx skills add https://github.com/lukefitzg/tinysocs --skill tinysocs-config-and-flags-lukefitzg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? TinySocs configuration is scattered across a C# agent YAML file, duplicated credential fallback chains, multiple Python env-var families, and a stale .env.example, making it hard to know what a setting actually defaults to or which variable wins when two exist. ## Core Features & Use Cases - Config Atlas: Maps every config file, env var, and default across the C# agent (AgentConfig.cs, ConfigLoader.cs) and Python services (dashboard, bot, node/federation, feed/licensing) with verified file paths and line numbers. - Trap Documentation: Explains real failure modes such as Detection.Pack.Enabled defaulting false, TLS verify flags defaulting insecure, LLM_MODE defaulting inconsistently across call sites, and the 9200-vs-9201 port gap. - Use Case: When an agent silently refuses to ship telemetry or federation refuses to start, consult this atlas to find that MASTER_SHARED_SECRET is fatal-if-unset or that TINYSOCS_QUEUE_PATH is silently ignored in favor of ACTIONS_QUEUE_PATH. ## Quick Start Ask what a specific TinySocs setting or environment variable defaults to and which config file or code path actually reads it.

Frequently Asked Questions about tinysocs-config-and-flags

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find what a TinySocs environment variable defaults to?

Look up the variable in the atlas section for its service: dashboard and bot vars in section 3.1, node and federation vars in 3.2, feed and licensing vars in 3.3. Each entry lists the default value, source file, and line number verified against the repository.

Why does my TinySocs agent start but ship no telemetry?

The agent silently falls back to all defaults when agent-config.yml is missing, leaving no inputs configured. Also check Detection.Pack.Enabled, which defaults to false, so the signed pack path never runs unless explicitly enabled in the deployed YAML.

Why does TinySocs federation refuse to start?

node.py hard-fails with sys.exit(1) when MASTER_SHARED_SECRET is unset, printing a FATAL message to stderr. bot.py similarly fatal-exits when BOT_SHARED_SECRET or NODE_SECRET is missing, so all shared secrets must be set before startup.

Does setting TINYSOCS_INSECURE_SKIP_VERIFY disable TLS verification everywhere?

No, the default is inconsistent across files: bot.py and master.py default to verification on, while check_ledger.py defaults to skipping verification. Several dashboard.py httpx calls hardcode verify=False unconditionally and ignore the env var entirely.

Why is TINYSOCS_QUEUE_PATH being ignored by the bot?

When the tinysocs.agent.actions_queue module imports successfully, QUEUE_PATH is built from ACTIONS_QUEUE_PATH only and TINYSOCS_QUEUE_PATH is never read. Set ACTIONS_QUEUE_PATH instead, despite what the .env.example comment implies.

When should I not use this configuration atlas?

Do not use it for detection rule schema fields, installer and NSSM service mechanics, change-control decisions about flipping flags, or live symptom triage. Those belong to the detection-engineering, run-and-operate, change-control, and debugging-playbook skills respectively.