Codex Plugin

Prerequisites: Thrum installed and initialized (thrum init), and Codex installed with a local skills directory (~/.codex/skills).

Overview

Codex does not currently use the Claude-style plugin marketplace model. Instead, Thrum integration is packaged as a Codex skill bundle in codex-plugin/skills.

The Codex bundle mirrors the Claude plugin's thrum:* command surface as top-level Codex skills.

Registered skills:

Prerequisites

If you have not initialized Thrum yet:

thrum init  # also starts the daemon automatically
thrum quickstart --name myagent --role implementer --module auth

Installation

From GitHub

Clone the Thrum repository and run the install script:

git clone https://github.com/leonletto/thrum.git
cd thrum
./codex-plugin/scripts/install-skills.sh

You can also use the packaged installer guide in codex-plugin/INSTALL.md, which points at the same script and lists the expected 15 installed skills.

From Local Clone

If you already have the Thrum repository cloned locally:

cd /path/to/thrum
./codex-plugin/scripts/install-skills.sh

This installs the bundled skills into ~/.codex/skills (or $CODEX_HOME/skills if CODEX_HOME is set).

Verify installed skills

find "${CODEX_HOME:-$HOME/.codex}/skills" -maxdepth 1 -type d \( -name "thrum" -o -name "thrum-*" \)

Restart Codex

Restart Codex after installation so the new skills are loaded.

Updating Skills During Development

After editing the Claude plugin source or Codex bundle files, sync updates into your local Codex installation:

./codex-plugin/scripts/sync-skills.sh

sync-skills.sh replaces installed copies with your local versions.

Usage Patterns

Multi-agent coordination

Ask Codex to coordinate work across agents using thrum. It acts as the main entry point and routes into the specific thrum-* command skills when the work becomes command-specific.

Session operations and triage

When you need one explicit workflow, invoke the matching command skill: thrum-prime, thrum-overview, thrum-inbox, thrum-send, and so on.

Role template generation

When team structure changes, use thrum-configure-roles to detect environment context and regenerate .thrum/role_templates/<role>.md with clear autonomy and scope boundaries.

Manual Installation (Optional)

If you prefer manual copy instead of scripts:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R codex-plugin/skills/thrum "${CODEX_HOME:-$HOME/.codex}/skills/"
cp -R codex-plugin/skills/thrum-* "${CODEX_HOME:-$HOME/.codex}/skills/"

Troubleshooting

Skills do not appear in Codex

Skill updates are not reflected

Thrum commands fail inside skill workflows

Codex Bundle vs Claude Plugin

Capability Codex Skill Bundle (codex-plugin/) Claude Code Plugin (claude plugin)
Packaging Local skill folders Marketplace plugin
Installation install-skills.sh claude plugin install thrum
Updates sync-skills.sh Reinstall/update plugin
Command UX Skill-guided CLI workflows Slash commands (/thrum:*)
Role customization thrum-configure-roles skill /thrum:configure-roles
Project decomposition thrum-project-setup skill /thrum:project-setup

Next Steps