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.