Getting Started¶

This guide explains how to install and configure the Claude Code Plugin for EventSourcingDB. At the end, you will have the plugin installed and connected to your EventSourcingDB instance.

Before You Begin

You need a running EventSourcingDB instance and a valid API token for it. If you haven't set one up yet, see Running EventSourcingDB.

Adding the Marketplace¶

The plugin is distributed through the thenativeweb plugin marketplace. Add it to Claude Code:

/plugin marketplace add thenativeweb/claude-plugins

You only need to do this once. The marketplace will be available in all future Claude Code sessions.

Installing the Plugin¶

Install the EventSourcingDB plugin from the marketplace:

/plugin install esdb@thenativeweb

Configuring the Connection¶

The plugin reads two environment variables to connect to your EventSourcingDB instance:

Variable	Description	Default
`ESDB_URL`	The base URL of your EventSourcingDB instance.	`http://localhost:3000`
`ESDB_API_TOKEN`	The API token used to authenticate with EventSourcingDB.	Claude will ask you if not set.

Set them in your shell before starting Claude Code:

export ESDB_URL="http://localhost:3000"
export ESDB_API_TOKEN="your-api-token"

Verifying the Connection¶

To verify that the plugin is installed and can reach your EventSourcingDB instance, type:

/esdb:ping

Claude will send a ping request to your EventSourcingDB instance and confirm whether the connection is healthy.

For a list of all available Skills and what they do, see Available Skills.