DOCS/FEATURES/BACKGROUND-TASKS

background tasks

Background & Cron Tasks

Andromity doesn't just respond to active chat queries. It can run persistent, asynchronous background tasks or execute routines on a recurring cron schedule.


What are Background Tasks?

If you initiate a long-running workflow — such as running a complex suite of 200 unit tests, waiting for a deployment container to build, or scanning a large file tree — Andromity moves this work to a background worker thread.

  • Non-Blocking: You can continue chatting, editing other files, or modifying configuration settings while the task executes.
  • Status Bar: A micro status indicator at the bottom of the TUI shows active background tasks.
  • Auto-Resumption: If a background task finishes or errors, Andromity alerts you with a notification box in the TUI, prompting you to review results.

Running Cron / Recurring Tasks

Use the /cron command to schedule the AI agent to monitor resources or run checks.

Example Cron Commands
BASH
# Run tests every hour to check for regressions
/cron "0 * * * *" "run npm test and report errors"

# Monitor server logs for error exceptions every 10 minutes
/cron "*/10 * * * *" "read storage/logs/laravel.log and alert if exceptions occur"

# Check database connection status every 2 hours
/cron "0 */2 * * *" "check if sqlite database connection is responsive"

To view all active schedules or cancel running background crons, run /cron list or /cron kill [id].