Repolode
jhutchings1

jhutchings1/opencode-scheduled-jobs

Runs scheduled OpenCode prompts on macOS via launchd, with agent tools and an OpenCode Desktop panel to manage them.

Stars
0
Forks
0
Open issues
0
Last commit
10 days ago

What is it?

opencode-scheduled-jobs lets you run OpenCode prompts on a recurring schedule on macOS, using launchd agents. Jobs can be created by asking the agent, which calls tools such as schedule_job, list_jobs, update_job and run_job, or through a Scheduled jobs side panel in OpenCode Desktop.

The Desktop panel shows each job's schedule, next run, run history and log, and lets you create, edit, run, stop, pause and delete jobs. A titlebar pill displays how many jobs are running or failed. It is designed as a V2 replacement for opencode-scheduler and reads and writes the same job files, so existing scheduled jobs continue without migration.

Each run executes opencode run in the job's working directory non-interactively, so questions are denied and prompts should be able to finish on their own. Job definitions, run records and logs are stored as plain files under ~/.config/opencode, and a timeout can be set for jobs that might hang. The OpenCode Desktop plugin API is marked experimental, so the panel may need updates.

Key features

  • 01Schedules recurring OpenCode prompts through macOS launchd agents.
  • 02Exposes agent tools to create, update, run, stop, pause and delete jobs.
  • 03Adds a Scheduled jobs panel in OpenCode Desktop with run history and logs.
  • 04Shows a titlebar indicator for running or failed jobs.
  • 05Reads and writes the same files as opencode-scheduler, so existing jobs carry over.

Use cases

  • Generating a daily summary of recent commits in a repository.
  • Running recurring maintenance prompts in a project directory on a fixed timetable.
  • Pausing and resuming scheduled OpenCode work without deleting job definitions.

Quick start

  1. 1

    Add the plugin to your global OpenCode config

    opencode plugin add opencode-scheduled-jobs
  2. 2

    Ask the agent to schedule a prompt, or open the Scheduled jobs panel in OpenCode Desktop and click New job

Things to know

  • Works only on macOS because it relies on launchd.
  • The OpenCode Desktop plugin API is experimental, so the panel may need updates as OpenCode changes.
  • Prompts and logs are stored in plain text, so secrets should not be included in them.

In collections

Topics

FAQ

What is opencode-scheduled-jobs?
Runs scheduled OpenCode prompts on macOS via launchd, with agent tools and an OpenCode Desktop panel to manage them. opencode-scheduled-jobs lets you run OpenCode prompts on a recurring schedule on macOS, using launchd agents. Jobs can be created by asking the agent, which calls tools such as schedule_job, list_jobs, update_job and run_job, or through a Scheduled jobs side panel in OpenCode Desktop.
Is opencode-scheduled-jobs free to use? What license does it have?
opencode-scheduled-jobs is open source under the Other license. Check the license terms before using it in commercial products.
Is opencode-scheduled-jobs still maintained?
Actively maintained. The last commit to opencode-scheduled-jobs was on Oct 28, 2026.
What can I use opencode-scheduled-jobs for?
Generating a daily summary of recent commits in a repository. Running recurring maintenance prompts in a project directory on a fixed timetable. Pausing and resuming scheduled OpenCode work without deleting job definitions.
How do I install opencode-scheduled-jobs?
Add the plugin to your global OpenCode config: opencode plugin add opencode-scheduled-jobs Ask the agent to schedule a prompt, or open the Scheduled jobs panel in OpenCode Desktop and click New job
Where can I get opencode-scheduled-jobs?
The source code and installation instructions are on GitHub: https://github.com/jhutchings1/opencode-scheduled-jobs

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects

A free, open-source macOS app that lists all startup items, daemons and login items in one window, showing their code-signing identity and enable/disable controls.

Developer Tools#macos#startup-items#launchd
611+5 this week27SwiftMITUpdated 2 months ago