Scheduled Jobs
Housecat can be configured to do work automatically for you any time of the day.
- User
-
Send me my daily brief every weekday at 7AM.
- Housecat
-
Created a job to “Run imogen/daily-brief/JOB.md” every weekday at 7AM
How It Works
Chat with your agent, or browse to the jobs page, to set up a scheduled job.
Under the hood, your VM is running 24/7 and every minute it checks the jobs database to see if there is something configured to do. When there is something to do, Housecat either starts a conversation through the AI Agent, or runs the script or program.
Conversation starts a conversation with the agent. This is extremely flexible but not very deterministic due to lack of “context”.
Conversation examples: “tell me a cat fact”, “send me a slack DM with my daily briefing”
Doc follows instructions in a Markdown file. This also is extremely flexible, and provides a lot of context and guidance to the agent to perform the job.
Doc examples: imogen/morning-briefing/JOB.md
Script runs a script. This is a rigid set of instructions that orchestrates its own LLM calls if needed.
Script examples: imogen/morning-briefing/job.py, shared/daily-backups/backup.py
Program runs a program. Similar to a script but with a few extra mechanics to build and/or install a full program.
Program examples: shared/rclone/cmd/backup
Job Activity
You can view recent job runs, conversations, and their outputs on the jobs page.