Introduction

When setting up scheduled tasks in DeepSeek Harness (dsh web), common requirements aren’t just running scripts on time. They include checking execution results, reviewing outputs, pushing notifications after completion, and organizing Agent/Skill sessions centrally. Existing methods often require configuring in system crontab or external schedulers, then handling output and notifications separately. chicheng-cron puts these scheduled tasks into the dsh web sidebar entry for configuration and viewing.

What is this

chicheng-cron is a scheduled task plugin for DeepSeek Harness (dsh web), maintained by 534119219, licensed under MIT. It uses cron expressions to execute Shell/Python/Node.js scripts, Skills, or Agent tasks at scheduled times, and supports push notifications, session organization, and mobile adaptation.

Core Features

The sidebar entry is located below the “New Chat” button and is named “Scheduled Tasks”.

Task types include:

  1. Shell scripts: Windows uses cmd.exe, other platforms use /bin/sh.
  2. Python scripts: automatically detects python / py / python3.
  3. Node.js scripts: uses the current Node runtime.
  4. Skill tasks.
  5. Tasks handed to Agents.

Scheduling supports standard 5/6-field cron, @hourly to @yearly, and @every, uses local time calculation, and automatically restores after restart.

Push notifications can interface with chicheng-push and messaging-core, and support template placeholders.

Agent/Skill execution sessions can be organized into the “Scheduled Tasks” workspace; sessions can also be configured to archive automatically after success.

Execution history records status, exit codes, duration, push results, and archive flags, and supports viewing outputs via popups.

Mobile adaptation includes narrow-screen single-page navigation, execution history collapsed by default, 16px input to prevent iOS zoom, and safe area adaptation.

Installation and Enablement

First, install the plugin:

dsh plugin --profile web add github:534119219/chicheng-cron

After installation, restart dsh web, and the “Scheduled Tasks” button will appear below “New Chat” in the left sidebar.

Typical Usage

  1. Click “Scheduled Tasks” in the sidebar and create a new task.
  2. Select task type, fill in name, cron expression, script or prompt, working directory, and timeout.
  3. Configure push notifications, Agent/Skill session grouping into “Scheduled Tasks”, and auto-archive sessions after success as needed.
  4. After saving, it executes automatically according to cron; you can also use “Run Now” to trigger manually and check results and outputs in execution history.

Data and Limits

Tasks and history are stored in:

$DSH_HOME/cron/store.json

Run outputs are saved in:

$DSH_HOME/cron/runs/

Agent/Skill tasks are executed via the following command:

dsh --profile headless

It reuses model configuration from:

$DSH_HOME/settings.yaml

If dsh web is not running when a scheduled time is missed, it will not run immediately to catch up.

Applicable Scenarios and Notes

Suitable for developers who need to maintain scheduled scripts, Skills, or Agent tasks in dsh web and view execution history and outputs.

The plugin executes Shell/Python/Node.js scripts, Skills, or Agent tasks and runs with the current dsh process permissions; before installation, check the source code and MIT license, then confirm task content, working directory, and timeout settings.

Links

GitHub: https://github.com/534119219/chicheng-cron