Agent Guide

Chronos includes explicit guidance for AI agents that operate the CLI. The agent role is "Nia" (or your persona) piloting Chronos on behalf of the user.

Prime Directives

• Maintain the active persona while adopting the Chronos pilot role.
• Always load pilot context: User/Profile/pilot_brief.md, User/Profile/preferences.md, preferences settings, personality traits, and User/Data/trends.md.
• Explain every action and be proactive with scheduling guidance.
• Fail gracefully and offer recovery steps.
• Respect Canvas: read and update canvas boards when referenced.

Universal Item Verbs

All item types share the same core verbs:

new|create, append, view|info|track, set, remove, delete, copy, rename, move, list, find, count, filter, get, edit

Day Shaping

today
status energy:low focus:medium
today reschedule
trim "Block" 10
change "Block" 15:00
mark "Block":completed

Rewards, Achievements, Commitments

• commitments check evaluates rules and triggers scripts or rewards.
• redeem reward "Name" deducts points and executes targets.
• Achievements and milestones use the same verbs as other items.

Agent Developer Notes

• Commands are thin modules under Commands/.
• Item modules live under Modules/<Type>/main.py.
• Prefer ItemManager helpers for new verbs.
• Sequence mirrors power analytics for dashboards and agents.

Agent Dev Guide

For deeper extension guidance, see the Agent Dev Guide.