Hook
A hook is an event-driven trigger that runs Theo automatically when something happens — a project is created, a share is accepted, a task goes overdue, a forum reply lands.
In depth
Hooks fire on platform events (share.accepted, task.overdue, project.created, team.member_joined, forum.post_replied). Each hook has a cooldown, a per-hook prompt template, credit guards, and an audit log.
Hooks are opt-in and can be disabled per user or globally. They share the autonomous daily cap with skills and workflows.
Examples
- Share-accepted welcome message
- Task-overdue summary
Also known as
Want to put this concept to work in OpenCharts?
Install hooksRelated terms
Skill
A skill is an installable extension that gives Theo a new behavior — a domain prompt, custom tools, allowed base tools, and an optional trigger (manual, event, schedule, or keyword).
Workflow
A workflow is a multi-step automation — tool calls, AI transforms, conditions, delays, and notifications wired together with branching logic and credit checkpoints.
Autonomous Daily Cap
The autonomous daily cap is a separate per-day credit budget for background actions — heartbeats, hooks, and workflows — so they can never drain your interactive credit balance.