Skip to main content
plugin CX Codex

plori — Claude Code plugin: what it does, how to install

Connects your assistant to persistent plori cloud agents over remote MCP with bundled skill instructions and OAuth sign-in.

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 plori@awesome-codex-plugins
Open on GitHub

What plori does

The plugin links your assistant session to the remote MCP endpoint at https://api.plori.ai/mcp. It exposes tools like create_agent, invoke_agent, schedule_run, and get_run_result, while teaching the model how to trigger tasks, poll status, and handle human-in-the-loop steps.

No local executable code is included. The bundle only registers the remote endpoint and the skill file. Authentication happens on the first tool call via OAuth 2.1 through an email verification code. Executing an agent consumes credits from your plori balance.

A single invoke_agent call holds for roughly 50 seconds before returning a run_id with a recommended polling interval. When tasks run longer, status checks continue with get_run_result, or you can track progress externally using the plori CLI version 0.4.0 or newer.

What it helps with

  • spin up an AI agent inside a persistent cloud runtime
  • run long background operations through remote MCP tools
  • schedule deferred agent executions in the cloud
  • send approval responses to paused interactive runs

Example prompts for the agent

  • Create a plori agent and invoke it to run tests in its cloud environment
  • Check the status of my plori run using its run_id
  • Schedule a background plori run via schedule_run

How to install plori

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install plori@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about plori

How to install plori in Claude Code?

Run both steps in order: first /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install plori@awesome-codex-plugins.

What does plori do?

It gives your assistant tools and instructions to create, trigger, and inspect autonomous AI agents hosted on plori cloud infrastructure.

What credentials are required to use plori?

You need an active plori account with credits. The plugin initiates an OAuth 2.1 email verification code flow on the first tool call.

Source text

codex-plugin · MIT
# plori Codex plugin

A one-install plugin for [plori](https://plori.ai): persistent cloud environments for AI agents,
with durable disks, real tools, and memory that stays with each agent.

Installing this plugin gives Codex two things at once:

- **The plori MCP server** (`.mcp.json`): the remote server at `https://api.plori.ai/mcp`,
  so `create_agent`, `invoke_agent`, `schedule_run`, and the rest become tools in your
  Codex session. Authentication is OAuth 2.1, auto-detected on first use (sign in once
  with an email code), or an API key.
- **The plori skill** (`skills/plori/SKILL.md`): teaches Codex how to connect, create
  agents, invoke them and read replies, answer human-in-the-loop requests, and schedule
  deferred runs. Its content is the same one served at
  `https://plori.ai/.well-known/agent-skills/plori/SKILL.md`.

## Install

Add this marketplace, then install the plugin:

```
codex plugin marketplace add plori-ai/codex-plugin
codex plugin add plori@plori
```

The plori server is authenticated over OAuth 2.1 the first time Codex reaches a tool;
approve the one-time email sign-in when the browser opens. Running an agent spends credits
on your plori account.

### Or connect the MCP server directly (no plugin)

The plugin is a convenience wrapper. You can also add the remote server on its own:

```
codex mcp add plori --url https://api.plori.ai/mcp
codex mcp login plori
```

## Background runs

A plori run often takes longer than the tool call that started it. Codex gives an MCP
tool 60 seconds by default, and the plori server returns within that: `invoke_agent`
holds your call for about 50 seconds, then answers with a `run_id` and a
`poll_after_seconds` delay. Call `get_run_result` again after that delay until the run
completes or reports `awaiting_input`.

For work that runs for minutes, use the plori CLI, version 0.4.0 or later:

```sh
curl -fsSL https://plori.ai/install.sh | sh
plori login
plori watch --events terminal,input &   # one JSON line per run that ends or pauses
plori inbox                             # the same information, one shot
```

Each `plori watch` line names the run. Read the reply with `plori result <agent>
<run-id>`, and answer a paused run with `plori answer <run-id> <tool-call-id>
--approve`.

To let a single tool call run longer instead, add the plori server to
`~/.codex/config.toml` yourself, as in
[Or connect the MCP server directly](#or-connect-the-mcp-server-directly-no-plugin),
and set `tool_timeout_sec` on that entry:

```toml
[mcp_servers.plori]
url = "https://api.plori.ai/mcp"
tool_timeout_sec = 900
```

This plugin does not ship that value. The documented fields for a plugin-bundled
remote MCP server are `type`, `url`, and `headers`; none of them set a timeout. The
plugin-scoped config keys (`plugins."plori".mcp_servers.plori.*`) cover enabling a
server, its tool allowlists, and tool approval, not timeouts.

## What is inside

```
.codex-plugin/plugin.json           # the plugin manifest
.mcp.json                           # remote MCP server (api.plori.ai/mcp)
skills/plori/SKILL.md               # the plori skill
.agents/plugins/marketplace.json    # self-marketplace (lists this plugin at ./)
SECURITY.md                         # vulnerability disclosure policy
```

Nothing here runs local code or installs third-party software: the plugin only points
Codex at the hosted plori MCP server and adds the skill text.

## Links

- Site: https://plori.ai
- MCP connect guide: https://plori.ai/mcp
- Integration front door: https://plori.ai/agents.md
- CLI on npm: https://www.npmjs.com/package/@plori/cli
- Questions: [email protected]

## License

MIT

© plori · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

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

From the same set391

The whole set →

Project sponsors

Companies that keep this analytics open