Skip to content

README.md

Latest commit

 

History

History
64 lines (45 loc) · 1.43 KB

README.md

File metadata and controls

64 lines (45 loc) · 1.43 KB
Raw

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:4242 by default. To change:

export OPENUI_HOST=localhost
export OPENUI_PORT=4242

Verify Installation

In Claude Code:

/plugins

You should see openui-status listed.

Troubleshooting

  1. Check plugin is loaded: /plugins
  2. Check OpenUI is running on port 4242
  3. Check OpenUI server logs for [plugin] messages

Uninstall

Marketplace install:

/plugin uninstall openui-status@openui-plugins

Curl install:

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