self-starter — Claude Code plugin: events and installation
The self-starter plugin for Claude Code and Codex monitors plain-language event conditions in the background and resumes a task in the conversation when one is met.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install self-starter@awesome-codex-pluginsWhat self-starter does
Tell Codex what should trigger an action, such as starting an experiment after the GPU sits idle or comparing a finished training run with the previous one. Codex creates and tests a small probe. Self-Starter then watches files, logs, commands, local services, or web APIs and returns the task to your conversation when the probe fires.
You need macOS or Linux, Node.js 20 or newer, and the Codex app or CLI. On first launch, the plugin installs a matching runtime and bundled Deno, then starts a background service. Probes run as your current user by default; API-only probes can be restricted with probe.access: sandbox. Some probes need credentials for the services they monitor, so enter those through the CLI rather than chat or probe source.
What it helps with
- start an experiment after the GPU has been idle
- compare a finished training run with its predecessor
- watch files and logs for a change
- resume a task when a web API meets a condition
Example prompts for the agent
- Start the next experiment when the GPU has been idle for ten minutes.
- Compare this training run with the previous one when it finishes.
- Watch
service.logand continue the task when an error appears.
How to install self-starter
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install self-starter@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about self-starter
How do I install self-starter in Claude Code?
Run these commands in order: /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install self-starter@awesome-codex-plugins.
What does self-starter do?
It turns an event description into a probe, checks it in the background, and resumes the Codex task in your conversation when the condition is met.
What does self-starter need to run?
It requires macOS or Linux, Node.js 20 or newer, and the Codex app or CLI. A probe may also need credentials for the service it watches.
Source text
self-starter · MIT
# Self-Starter for Codex Define custom events in plain language and let Codex act when they happen, with no model tokens spent while waiting. For example: "When the GPU has been idle for ten minutes, start the next experiment" or "When this training run finishes, compare it with the previous one." Codex writes and tries a small probe, then Self-Starter checks it in the background and brings the task back to your conversation when it fires. Probes can watch files, logs, commands, local services and web APIs. ## Install Requires macOS or Linux, Node.js 20 or newer, and the Codex app or CLI. ```sh codex plugin marketplace add hyprh/self-starter codex plugin add self-starter@self-starter ``` Restart Codex after installation. The first start installs the matching runtime and bundled Deno from `hyprh/self-starter`, and starts its background service. Later starts use the installed runtime. No separate Self-Starter account is required; agent actions use your Codex setup, and particular probes may need credentials for the services they watch. ## Permissions Probes run as the current user by default. An API-only probe can use `probe.access: sandbox` to restrict it to declared network hosts and environment variables. Review the probe and action before activation. Enter service credentials with the CLI, never in chat or probe source. Read the [full guide](https://github.com/hyprh/self-starter/blob/main/docs/guide.md) and [security policy](SECURITY.md). ## Bundle layout The manifest declares `skills`, `mcpServers`, and `scripts: ./bin`. The scripts field tells catalog generators to retain the MCP launcher's `bin/` directory when mirroring this bundle; the launcher remains `bin/start.mjs`.
© hyprh · MIT · hashgraph-online/awesome-codex-plugins