wuyunjiang/chatgpt-task-hook — explained in plain English
Analysis updated 2026-07-25
Trigger a ChatGPT or Codex task automatically from another app using a webhook.
Pass dynamic data into a prompt using placeholder fields to get contextual results.
Run a background service on macOS that listens for task triggers on login.
Test task creation and delivery locally without using real AI quota.
| wuyunjiang/chatgpt-task-hook | 0xkinno/neuralvault | 0xmayurrr/ai-contractauditor | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | moderate | hard | easy |
| Complexity | 3/5 | 4/5 | 2/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires macOS, the ChatGPT or Codex desktop app installed locally, and running npm commands to start the service.
This is a local macOS tool that lets you trigger ChatGPT or Codex tasks through an HTTP API instead of scheduling them at fixed times. The author built it for personal use because the normal task scheduling in ChatGPT only supports time-based triggers, not event-based ones. The project provides a web interface styled to match ChatGPT's existing scheduled tasks panel, and it runs alongside the ChatGPT desktop app. Each task stores a prompt that gets sent to Codex or ChatGPT, with configurable options for the model, reasoning effort, project path, and execution target. You can create new tasks or continue existing ones. The service reads locally saved projects from the ChatGPT or Codex desktop client and uses them as working directories. When a task runs, the service tries to open the target task in the Codex desktop app and delivers the prompt through the same channel the desktop app uses for manual input. Triggering a task is done by sending an HTTP POST request to a local endpoint. If a task has a secret key configured, you include it in the request for authentication. Task prompts support placeholder fields using double curly braces, so you can pass dynamic data in your trigger request and the service fills it in. Nested fields work with dot syntax, and any unused fields in your request get appended to the prompt as extra context. If a placeholder has no matching parameter, the request fails with a 400 error. The service can run manually with standard npm commands, binding to a local port. For permanent use, it registers as a macOS LaunchAgent that starts on login, restarts on crash, and listens on a fixed local port. Logs and task data are stored in a local data directory. The project includes a smoke test that uses fake Codex components to verify task creation, continuation, and prompt delivery without consuming actual model quota.
A local macOS tool that lets you trigger ChatGPT or Codex tasks via HTTP webhooks instead of time-based schedules, with dynamic data placeholders.
Mainly TypeScript. The stack also includes TypeScript, Node.js, npm.
The explanation does not mention a license for this repository.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.