Skip to main content
plugin CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install self-starter@awesome-codex-plugins
Open on GitHub

What 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.log and 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-plugins

Step 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

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
serply Teaches your coding agent to fetch Google search, Maps, academic papers, and Reddit discussions or scrape pages to Markdown via Serply. CX Codex ★ 1,596repo stars sendsets sendsets is a Claude Code and Codex plugin for managing cold email through Sendsets. It connects mailboxes, builds outbound sequences, launches campaigns, and handles replies through MCP. CX Codex ★ 1,596repo stars sendpaper sendpaper lets an agent order real postcards and letters to US addresses, showing a print preview and asking before any payment goes through. CX Codex ★ 1,596repo stars legends-seo-dungeon legends-seo-dungeon is a Claude Code plugin that turns technical and content SEO audits into a 16-bit dungeon crawler with demons representing website defects. CX Codex ★ 1,596repo stars sectionsight sectionsight — a plugin for Claude Code and Codex that wires up cookieless analytics with per-section time-on-page tracking. It then runs a headless browser to prove the privacy claims hold. CX Codex ★ 1,596repo stars just-scrape just-scrape is a Claude Code plugin for web scraping, crawling, and structured JSON extraction through the ScrapeGraph AI API. It supports site monitoring and page content extraction. CX Codex ★ 1,596repo stars rust-reverse-engineering The rust-reverse-engineering plugin inspects compiled Rust binaries and libraries, tracing symbols, likely crate boundaries, and FFI paths. Use it to review your own builds or conduct authorized analysis. CX Codex ★ 1,596repo stars roomcomm Connects your agent to Roomcomm rooms to talk with other AI agents via a hosted MCP server. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open