UGENT Monitor

UGENT Monitor Plugin

UGENT Monitor reports Claude Code/Codex lifecycle events to a local UGENT endpoint and provides a ugent-resume skill plus a minimal dependency-free MCP server.

What this version fixes

• Claude Code marketplace source is Ralph-style "./", avoiding git-subdir and object-source compatibility issues.
• Codex MCP server now uses newline-delimited MCP stdio JSON-RPC, not LSP Content-Length framing.
• Codex MCP launch uses a Python inline bootstrapper that locates the installed plugin cache, working around current Codex relative-path behavior in plugin .mcp.json files.
• All manifests are versioned 0.1.10.

Claude Code install

/plugin marketplace remove ugent-monitor
/plugin marketplace add unizhu/ugent-monitor
/plugin marketplace update ugent-monitor
/plugin install ugent-monitor@ugent-monitor
/reload-plugins

Validate locally before pushing:

claude plugin validate .
claude plugin validate . --strict
claude --plugin-dir .

Claude root layout:

.claude-plugin/marketplace.json
.claude-plugin/plugin.json
skills/ugent-resume/SKILL.md
commands/ugent-resume.md
hooks/hooks.json
.mcp.json
bin/ugent-monitor-mcp.py

Codex install

codex plugin marketplace remove ugent-monitor
rm -rf ~/.codex/.tmp/marketplaces/ugent-monitor
rm -rf ~/.codex/plugins/cache/ugent-monitor
codex plugin marketplace add unizhu/ugent-monitor
codex plugin marketplace upgrade ugent-monitor
codex

In Codex, install/enable the plugin in /plugins. Then inspect MCP:

/mcp

Expected server/tool after the plugin is enabled:

ugent-monitor
mcp__ugent-monitor__ugent_get_resume_plan

Codex nested layout:

.agents/plugins/marketplace.json
plugins/ugent-monitor/.codex-plugin/plugin.json
plugins/ugent-monitor/.mcp.json
plugins/ugent-monitor/skills/ugent-resume/SKILL.md
plugins/ugent-monitor/hooks/hooks.json
plugins/ugent-monitor/bin/ugent-monitor-mcp.py

Environment variables

Optional runtime integrations:

export UGENT_MONITOR_URL="http://127.0.0.1:8786"
export UGENT_RESUME_PLAN_FILE="$HOME/.ugent/resume-plan.json"

The MCP tool falls back to a safe static resume plan when neither variable is set.

Claude Code note: project .mcp.json vs plugin MCP

This repository contains a root .mcp.json because Claude Code plugins bundle MCP servers from the plugin root. If you open Claude Code while your current working directory is this repository, Claude Code will also detect that same file as a project-scoped MCP config. That is expected.

The server uses ${CLAUDE_PLUGIN_ROOT:-.} so it works in both modes:

• Installed plugin mode: ${CLAUDE_PLUGIN_ROOT} points at Claude's plugin cache.
• Source-repo/project mode: the fallback . points at this repository root.

To test the installed plugin without the project-level .mcp.json taking precedence, open Claude Code from another project directory.

Claude MCP note

The Claude plugin declares its MCP server inline in .claude-plugin/plugin.json so the repository root does not need a project-scoped .mcp.json. This avoids a duplicate project-vs-plugin MCP warning when developing from this repository. Codex still uses plugins/ugent-monitor/.mcp.json for its nested plugin root.