Skip to main content

Watch a folder and report what changed

Ten minutes. At the end, something writes you a short report of what moved in a directory, on whatever schedule you choose — a project, a shared drive, a folder somebody else keeps putting things in.

1. Point a chat at the folder​

Open a new chat and use the folder button above the composer to choose the directory.

This matters more than it looks: the agent may write anywhere inside the directory a chat is open in, and nowhere outside it. Choosing the folder is choosing the blast radius.

2. Ask for the report once​

Use the weekly-report skill on this folder.

The weekly-report skill ships with the product. It works out what changed — from git if the folder is a repository, from modification times otherwise — and writes three sections: what finished, what is underway, and what needs a decision.

That last section is the reason to read it.

3. Put it on a schedule​

Background runs → Schedule a repeating one:

Field
What should it doUse the weekly-report skill on this folder. Save it as report-<date>.md.
NameWeekly report
How often7 days
Where to runthe folder you chose

4. Check where it will run​

If the folder is not inside your workspace and not a department, the first run will be held rather than started, and appear under Waiting for you.

That is deliberate. Allow the directory, or move the task into a department.

5. Read the first one​

Run now, then open the run to read the output as it is produced.

If the report is thin, the folder had a thin week — the skill is told to say so in one line rather than padding, because a report padded out of an empty week teaches people to skip reports.

Doing this to somebody else's folder​

Two things worth being careful about.

The agent reads everything it is pointed at, and reads are not restricted by the sandbox in any mode. A folder with things you would not send to your model provider should not be the folder you point it at — unless your model is on your own machine, in which case nothing leaves it.

A schedule outlives your attention. Something that runs weekly for a year is fifty-two runs you did not watch. Keep the directory tight.