Connectors

Connectors sync external sources into your knowledge base automatically.

Available Connectors

Connector	Type	Setup
Chrome	Browser bookmarks	km import chrome
Firefox	Browser bookmarks	km import firefox
Safari	Browser bookmarks (macOS)	km import safari
GitHub Stars	API	km import github <username>
Readwise Reader	API	km import readwise --token TOKEN
Karakeep	API	Dashboard settings

Viewing Connectors

km connector list

Shows all configured connectors with their last sync time, item count, and health status.

Scheduling Automatic Sync

Set a polling interval to keep a connector in sync:

km connector schedule <connector-name> <interval>

Intervals can be specified as:

• 6h — Every 6 hours
• 1d — Once a day
• 12h — Every 12 hours

Example:

km connector schedule github 1d

Note

Scheduled sync requires the background service to be running. Install it with km service install.

Karakeep Setup

Karakeep uses a live API connection with incremental sync:

1. Start the dashboard: km serve
2. Go to Settings
3. Under Karakeep, enter:
4. Server URL — Your Karakeep instance URL
5. API Token — Your Karakeep API bearer token
6. Click Connect

After connecting, Karakeep syncs automatically. New bookmarks saved in Karakeep appear in Knowmarks on the next poll.

Readwise Reader Setup

1. Get your API token from readwise.io/access_token
2. Run the initial import:

   km import readwise --token YOUR_TOKEN
   

Readwise imports include highlights and annotations as notes on each knowmark.

Connector Health

Check connector health from the CLI:

km connector list

Or from the dashboard Pulse view, which shows connector status including last sync time and any errors.

If a connector shows errors, the dashboard provides a Reconnect action to retry the connection.