<div align="center">

Hermes IDE Plugins

Official plugin registry and development resources for Hermes IDE.

</div>

---

Structure

registry/       Plugin registry index
plugins/        Official and community plugins (approved by Hermes IDE)
templates/      Plugin project templates
docs/           Development guides and API reference

Documentation

• Development Guide — How to create and test plugins
• Plugin API Reference — Full API documentation
• Manifest Reference — hermes-plugin.json schema
• Contributing — How to submit a plugin for review

Creating a Plugin

1. Copy the templates/basic/ directory 2. Update hermes-plugin.json with your plugin's metadata 3. Install dependencies: npm install 4. Build: npm run build 5. Copy the output directory to your Hermes IDE plugins folder:

• macOS: ~/Library/Application Support/com.hermes-ide.terminal/plugins/your-plugin-id/
• Linux: ~/.config/com.hermes-ide.terminal/plugins/your-plugin-id/
• Windows: %APPDATA%/com.hermes-ide.terminal/plugins/your-plugin-id/

See the Development Guide for a detailed walkthrough including symlink-based dev workflow, theming, and API usage.

Plugin Format

Each plugin is a directory containing:

your-plugin-id/
├── hermes-plugin.json    # Plugin manifest
└── dist/
    └── index.js          # IIFE-bundled JavaScript

Manifest (hermes-plugin.json)

| Field | Type | Description | |-------|------|-------------| | id | string | Unique plugin identifier (e.g., author.plugin-name) | | name | string | Display name | | version | string | Semver version | | description | string | Short description | | author | string | Author name | | main | string | Path to the IIFE bundle (relative to plugin dir) | | activationEvents | array | When the plugin should be activated | | contributes | object | What the plugin provides (commands, panels, status bar items) | | permissions | array | Required permissions (storage, network, clipboard.read, clipboard.write, notifications, sessions.read) |

Build Configuration

Plugins must be built as IIFE bundles with React externalized:

• Use jsx: "react" (classic runtime) in tsconfig.json
• Externalize react in Vite/Rollup config
• React is provided as window.React by the host app

Plugin Review Process

All plugins in this registry are reviewed and approved by the Hermes IDE team. The app only installs plugins from this official registry — there is no way to install arbitrary plugins from external sources.

To submit a plugin:

1. Fork this repository 2. Add your plugin to plugins/your-plugin-name/ 3. Add an entry to registry/index.json 4. Open a Pull Request

See CONTRIBUTING.md for full details and review criteria.

Official Plugins

| Plugin | Description | |--------|-------------| | JSON Formatter | Format, minify, and validate JSON | | UUID Generator | Generate UUIDs in all standard versions (v1, v4, v5, v7) with batch support | | Pomodoro Timer | Focus timer with configurable work and break intervals, notifications, and session tracking | | Session Notes | Markdown scratchpad for each terminal session with auto-save and session-aware switching | | Regex Tester | Test regular expressions with live match highlighting, capture groups, and common presets | | RSS Feed Reader | Subscribe to RSS and Atom feeds, browse articles, and get notified of new content without leaving the terminal | | Pixel Office | Visualize AI coding agents as animated pixel art characters in a virtual office | | IP & Network Info | Public IP lookup, DNS queries, WHOIS, local interfaces, ping, and traceroute | | Markdown Preview | Live preview of Markdown files with full GFM support, auto-refresh, and file scanning |

License

Official plugins are licensed under Apache 2.0.