Chrome Extension

The Knowmarks Chrome extension provides one-click saving from your browser with optional notes.

Installation (Developer Mode)

The extension is not yet published to the Chrome Web Store. Install it as an unpacked extension:

1. Open Chrome and navigate to chrome://extensions
2. Enable Developer mode (toggle in the top-right corner)
3. Click Load unpacked
4. Select the extension/ folder from the Knowmarks repository

The Knowmarks icon appears in your browser toolbar.

Usage

1. Navigate to a page you want to save
2. Click the Knowmarks icon in the toolbar
3. Optionally add a note
4. Click Save

The extension sends the URL (and optional note) to your local Knowmarks server via the REST API.

Configuration

Click the extension icon and select Options (or right-click the icon and choose "Options") to configure:

• Server URL — The address of your Knowmarks server. Defaults to http://localhost:3749.
• API Key — If you've set KNOWMARKS_API_KEY, enter the same key here for authenticated saves.

Troubleshooting

Extension doesn't save

• Is the server running? Start it with km serve
• Correct server URL? Check the extension options. Default is http://localhost:3749.
• API key mismatch? If you've set KNOWMARKS_API_KEY on the server, the extension needs the same key in its options.
• CORS issue? The Knowmarks server allows requests from Chrome extensions by default.

Extension icon is grayed out

The extension only activates on http:// and https:// pages. It won't activate on chrome:// pages, the new tab page, or file:// URLs.

Updating the extension

After pulling new code, go to chrome://extensions and click the reload icon on the Knowmarks extension card.