Agent Dev Guide

Extend Chronos by adding commands, item modules, or dashboard widgets.

System Overview

• Console: Modules/Console.py parses input and dispatches commands.
• Commands: Commands/*.py thin wrappers around modules.
• Modules: Modules/<Type>/main.py item-specific logic.
• Item Manager: Modules/ItemManager.py handles YAML IO and generic verbs.

Adding an Item Type

1. Create Modules/<Type>/main.py with ITEM_TYPE and handle_command.
2. Add defaults in User/Settings/<type>_defaults.yml.
3. Document usage in the guides.

Adding a Command

1. Create Commands/<Name>.py with run(args, properties).
2. Prefer ItemManager helpers instead of manual IO.
3. Update docs and test via CLI or a .chs script.

Dashboard Extensions

• Widgets live in Utilities/Dashboard/Widgets/<Name>/.
• Panels live in Utilities/Dashboard/Panels/<Name>/ and register via the Cockpit manager.
• Wizards live in Utilities/Dashboard/Wizards/<Name>/ and expose launch().