Skill

read-subjects

Read subjects from an EventSourcingDB instance. Use when the user wants to list, browse, or discover which subjects exist in the event store.

npx claudepluginhub thenativeweb/claude-plugins --plugin esdb

Tool Access

This skill is limited to using the following tools:

BashAskUserQuestion

Preview

List subjects that have received events in an EventSourcingDB instance.

SKILL.md

Similar Skills

ui-ux-pro-max

70.8k

Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.

ui-ux-pro-max

github-deep-research

63.9k

Conducts multi-round deep research on GitHub repos via API and web searches, generating markdown reports with executive summaries, timelines, metrics, and Mermaid diagrams.

2 files

bytedance-deer-flow-1

surprise-me

63.9k

Dynamically discovers and combines enabled skills into cohesive, unexpected delightful experiences like interactive HTML or themed artifacts. Activates on 'surprise me', inspiration, or boredom cues.

bytedance-deer-flow-1

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitMar 29, 2026

Actions

View Source View Plugin View on GitHub View README

Read Subjects

List subjects that have received events in an EventSourcingDB instance.

Configuration

Read configuration from environment variables:

echo "ESDB_URL: ${ESDB_URL:-http://localhost:3000}" echo "ESDB_API_TOKEN: ${ESDB_API_TOKEN:-(not set)}"

Use ESDB_URL if set, otherwise default to http://localhost:3000.

If ESDB_API_TOKEN is not set, use AskUserQuestion to ask the user for the API token.

Request

This endpoint returns NDJSON. Use --no-buffer and filter out heartbeats:

curl -s --no-buffer -X POST \ -H "authorization: Bearer ${ESDB_API_TOKEN}" \ -H "content-type: application/json" \ -d '<REQUEST_BODY>' \ "${ESDB_URL:-http://localhost:3000}/api/v1/read-subjects" \ | grep -v '"type":"heartbeat"'

Request Body

{ "baseSubject": "/" }

Example

curl -s --no-buffer -X POST \ -H "authorization: Bearer ${ESDB_API_TOKEN}" \ -H "content-type: application/json" \ -d '{"baseSubject": "/"}' \ "${ESDB_URL:-http://localhost:3000}/api/v1/read-subjects" \ | grep -v '"type":"heartbeat"'

Response

NDJSON stream with one line per subject:

{"type":"subject","payload":{"subject":"/books/42"}}

Conventions

Subjects always start with / (e.g., /books/42, /readers/23).

Read Subjects

List subjects that have received events in an EventSourcingDB instance.

Configuration

Read configuration from environment variables:

echo "ESDB_URL: ${ESDB_URL:-http://localhost:3000}"
echo "ESDB_API_TOKEN: ${ESDB_API_TOKEN:-(not set)}"

Use ESDB_URL if set, otherwise default to http://localhost:3000.
If ESDB_API_TOKEN is not set, use AskUserQuestion to ask the user for the API token.

Request

This endpoint returns NDJSON. Use --no-buffer and filter out heartbeats:

curl -s --no-buffer -X POST \
  -H "authorization: Bearer ${ESDB_API_TOKEN}" \
  -H "content-type: application/json" \
  -d '<REQUEST_BODY>' \
  "${ESDB_URL:-http://localhost:3000}/api/v1/read-subjects" \
  | grep -v '"type":"heartbeat"'

Request Body

{
  "baseSubject": "/"
}

Example

curl -s --no-buffer -X POST \
  -H "authorization: Bearer ${ESDB_API_TOKEN}" \
  -H "content-type: application/json" \
  -d '{"baseSubject": "/"}' \
  "${ESDB_URL:-http://localhost:3000}/api/v1/read-subjects" \
  | grep -v '"type":"heartbeat"'

Response

NDJSON stream with one line per subject:

{"type":"subject","payload":{"subject":"/books/42"}}

Conventions

Subjects always start with / (e.g., /books/42, /readers/23).