Skip to content

Chrome Extension

Jump to bottom
Chokri Hammedi edited this page Apr 21, 2026 · 2 revisions

Chrome Extension

The Chrome extension provides a compact popup interface for Rosemary without opening the full web dashboard. It connects to a running server and gives quick access to agents, forwards, routes, logs, and settings.

Installation

  1. Open Chrome and go to chrome://extensions/
  2. Enable Developer mode using the toggle in the top right
  3. Click Load unpacked
  4. Select the extension/ folder from the repository

The Rosemary icon will appear in the browser toolbar.

Connecting to the Server

Click the extension icon to open the popup. On first use you will be prompted to enter:

  • Server IP: e.g. 192.168.1.1 localhost
  • Port: e.g. 1024
  • Key: your AES-256 base64url key

The extension authenticates via POST /api/v1/auth and stores the Bearer token in chrome.storage.local. You stay logged in until the token expires or you log out.

Tabs

Agents

Lists all connected agents as expandable cards. Each card shows:

  • OS icon, hostname, username
  • Discovered subnets
  • Internet access status
  • Custom tag

Expand a card to access inline action panels:

Action Description
Port Forward Add a TCP or UDP forward through the agent
Reverse Forward Add a reverse forward
Ping Ping a host via the agent
Port Scan Run a TCP or UDP port scan
Tag Set a display name
Reconnect Force the agent to reconnect
Disconnect Disconnect the agent
Connect Bind Connect to a bind-mode agent by address

Forwards

View and delete active TCP and UDP port forwards.

Routes

View the routing table and toggle individual subnet routes on or off.

Logs

View the server log and CLI log output. Refreshes on demand.

Settings

Option Description
Server URL Change the server address
Regenerate Key Generate a new AES encryption key on the server
Shutdown Gracefully shut down the server
Theme Toggle light or dark mode
Open Dashboard Open the full web dashboard in a new tab

Permissions

The extension requests the following permissions:

Permission Reason
storage Save server URL and auth token locally
cookies Session handling
http://*/* Communicate with the server over HTTP
https://*/* Communicate with the server over HTTPS

Use only on systems you own or have explicit written permission to test. Unauthorized use is prohibited.

Clone this wiki locally