takopi-cron 0.0.3

Cron command plugin for Takopi.

takopi-cron

cron command plugin for takopi. run a prompt on an interval and post results back into your chat.

This is intentionally simple:

• It runs in-process inside Takopi (so Takopi must be running).
• It does not survive restarts (you re-run /cron start after restart).

requirements

uv for installation (curl -LsSf https://astral.sh/uv/install.sh | sh)

python 3.14+ (uv python install 3.14)

takopi installed

install

recommended (installs the plugin into takopi's uv tool environment):

uv tool install -U takopi --with takopi-cron

if you installed takopi via pip (or you're running takopi from a project venv), install the plugin into the same environment:

pip install -U takopi-cron

enable it:

[plugins]
enabled = ["takopi-cron"]

usage

Start a job (runs once immediately, then repeats):

/cron start 6 Write a summary of today's PRs and what I should review next.

Stop the job for the current chat/thread:

/cron stop

Status:

/cron status

List all running cron jobs:

/cron list

Run once (no scheduling):

/cron run What changed since yesterday?

Seed presets (from config):

/cron seed list
/cron seed start daily_summary

Seed presets start in the chat/thread where you run the command.

Tips:

• Put an engine directive at the start of the prompt, e.g. /claude ...
• Put a project directive at the start of the prompt, e.g. /myproj ...
• Put a branch directive at the start of the prompt, e.g. @feat/foo ...

config

In ~/.takopi/takopi.toml:

[plugins.cron]
# Optional: restrict who can control cron jobs
allowed_user_ids = [12345678]

# Optional: whether cron ticks should notify (default: true)
notify = true

# Optional: seed presets (saved cron definitions). they do not auto-start; you
# start them later with `/cron seed start ...`.
[[plugins.cron.seed]]
id = "daily_summary"
every_hours = 6
prompt = "/codex summarize what changed since the last cron tick"
# notify = true            # optional override
# enabled = false          # optional