# Schedule the recurring scripts

> The one scheduled job a CBX store needs, what it does, and how to tell that it is running.

Source: CBX documentation, version 3.x (released). Canonical page: https://docs.configbox.at/docs/admin-guide/getting-started/schedule-the-recurring-scripts. Last updated 2026-08-13.

---
> **Audience:** store owners and whoever administers the site's server · **Scope:** the scheduled
> jobs a CBX store needs · **Last reviewed:** 2026-07-29

Almost everything in CBX takes care of itself: routine cleanup runs during normal visits, and
nothing needs a nightly job just to keep the store selling. **One script is the exception** — it
only works when someone schedules it on the server.

## The AI assistant's journal sweep

If you use the **AI Configurator Assistant**, one command needs to run on a schedule:

```
php cli/joomla.php configbox:chatadvisor:analyze
```

Every run does two jobs:

- **It enforces the journal retention.** Conversations older than the retention period set in
  **Settings → AI Configurator Assistant** are deleted. That retention is a promise about visitor
  data — without the scheduled run, nothing deletes old conversations.
- **It writes the lessons-learned reviews.** Conversations that have gone quiet get their
  AI-written review (visible on each conversation in the journal). This part respects the
  "Analyze conversations automatically" setting; the retention part runs regardless.
- **It maintains the recommendations.** After the reviews, everything newly analysed is folded
  into the [Recommendations](https://docs.configbox.at/docs/admin-guide/ai-assistant/send-recommendations-to-your-team) backlog —
  new evidence joins what is already known, genuinely new problems open new entries, and a fixed
  problem that visitors hit again is flagged as regressed. Without the scheduled run, the
  backlog only moves when someone presses "Fold them in now" on the screen.

Ask whoever administers your server to schedule it — **once per hour** is a good rhythm. A
conversation is considered finished after it has been quiet for half an hour, so an hourly run
reviews conversations while they are still fresh.

If the store does not use the AI assistant, the command does nothing and nothing needs scheduling.

## How to tell that it is running

Open **AI Assistant → Conversation Journal** in the CBX menu and look at the **Analyzed**
column: with the sweep in place, conversations get their check mark on their own within an hour or
two of ending. If older conversations pile up unanalyzed (and never disappear after the retention
period), the schedule is not running — the **Analyze** button on each conversation still works
by hand in the meantime.