OpenUI Status Plugin for Claude Code #

Reports Claude Code agent status to OpenUI in real-time for accurate status display (Working, Using Tools, Idle, etc.).

Installation #

Automatic: OpenUI automatically pulls and installs this plugin when you run it. No manual installation required.

Manual (if needed):

curl -fsSL https://raw.githubusercontent.com/Fallomai/openui/main/claude-code-plugin/install.sh | bash

This installs to ~/.openui/claude-code-plugin/. OpenUI automatically uses it when starting Claude agents.

How It Works #

The plugin uses Claude Code hooks to report status:

Hook Event	Status
`SessionStart`	`starting`
`UserPromptSubmit`	`running`
`PreToolUse`	`tool_calling`
`PostToolUse`	`running`
`Stop`	`idle`
`Notification` (idle_prompt)	`waiting_input`
`SessionEnd`	`disconnected`

Configuration #

The plugin sends status to localhost:6968 by default (papyrus's server port). To change:

export OPENUI_HOST=localhost
export OPENUI_PORT=6968

(papyrus already injects OPENUI_PORT/OPENUI_HOST matching its actual server port when it spawns the agent, so you normally never need to set these by hand.)

Verify Installation #

In Claude Code:

/plugins

You should see openui-status listed.

Troubleshooting #

Check plugin is loaded: /plugins
Check papyrus is running on port 6968
Check papyrus server logs for [plugin-hook] messages

Uninstall #

Marketplace install:

/plugin uninstall openui-status@openui-plugins

Curl install:

rm -rf ~/.openui/claude-code-plugin