Use in AI Tools

Use Everruns from the AI tools where you already work. The Everruns(Dev) plugin ships in this repository with both Claude Code and Codex support.

Claude Code

The Claude Code plugin connects Claude Code to https://dev.everruns.com/mcp and adds Everruns(Dev) tools, slash commands, and a skill with platform guidance.

Install the Plugin

Add the Everruns marketplace and install the plugin from inside Claude Code:
```
/plugin marketplace add everruns/everruns
/plugin install everruns-dev@everruns-dev
```
Claude Code reads .claude-plugin/marketplace.json from the repository to discover available plugins. The install syntax is <plugin-name>@<marketplace-name>.
Verify the install by running:
```
/everruns-dev:whoami
```
On first run the plugin opens an OAuth flow in your browser to authenticate against the Everruns(Dev) platform over MCP.

If /plugin is not recognized, update Claude Code to a version that supports the plugin marketplace and try again.

Use Everruns

Ask Claude Code for an Everruns task in natural language, for example:

Create an Everruns(Dev) agent that summarizes https://news.ycombinator.com/ and run it once.

The plugin also exposes slash commands such as /everruns-dev:agent-run, /everruns-dev:session-send, and /everruns-dev:discover for common workflows.

Alternative Install

To install from a local clone or point at a self-hosted Everruns deployment, see plugins/everruns-dev/README.md. To target another Everruns deployment, update the url in plugins/everruns-dev/.mcp.json to that deployment’s /mcp endpoint.

Codex

The Codex plugin connects Codex to https://dev.everruns.com/mcp and adds Everruns(Dev) tools and guidance.

Set Up the Marketplace

Add the Everruns plugin marketplace:

codex plugin marketplace add https://github.com/everruns/everruns.git

Restart Codex if Everruns(Dev) does not appear in the plugin directory.
Open the Codex plugin directory, choose the Everruns(Dev) marketplace source, and install Everruns(Dev).

Codex discovers the marketplace from .agents/plugins/marketplace.json. That marketplace points to ./plugins/everruns-dev, which contains the Codex plugin manifest and MCP server configuration.
Complete the browser OAuth flow when Codex asks you to authenticate.

For the general Codex marketplace format, see the Codex plugin marketplace documentation.

Use Everruns

Ask Codex for an Everruns task in natural language, for example:

Create an Everruns(Dev) agent that summarizes https://news.ycombinator.com/ and run it once.

To verify the connection, ask Codex:

Check my Everruns(Dev) user and active organization.

To point the plugin at another Everruns deployment, update the url in plugins/everruns-dev/.mcp.json to that deployment’s /mcp endpoint.