luminaria

Claude Code session sync plugin for Luminaria.

Automatically syncs your Claude Code sessions to your Luminaria knowledge base after every coding session, using Claude Code's SessionEnd hook.

Requirements

• Node.js 18+
• A Luminaria account with an API key

Installation

npm install -g luminaria

Setup

Run the interactive setup to configure your API key and install the hook:

luminaria setup

This will:

1. Ask for your Luminaria API key (get one from Settings > API Keys)
2. Set the server URL (defaults to production)
3. Save config to ~/.luminaria/config.json
4. Automatically add the SessionEnd hook to ~/.claude/settings.json

After setup, sessions sync automatically when they end.

Usage

Automatic (hook mode)

Once setup is complete, luminaria runs automatically when a Claude Code session ends. No manual action needed. Errors are logged to stderr and never interrupt your coding session.

Sync all existing sessions

Import all Claude Code sessions at once:

luminaria --all

Sync a specific file

luminaria --path ~/.claude/projects/my-project/session-abc123.jsonl

Help

luminaria

Configuration

Config is stored at ~/.luminaria/config.json:

{
  "api_key": "luminaria_...",
  "server_url": "https://api.luminaria.so"
}

How it works

1. Claude Code fires a SessionEnd hook event when a session closes
2. The plugin reads the session transcript (JSONL file)
3. It POSTs the content to Luminaria's /api/v1/sync endpoint
4. Luminaria creates atoms in your knowledge graph, deduplicating by UUID

Re-syncing the same session is safe — existing atoms are skipped, new ones are added.

Hook configuration

The setup command adds this to ~/.claude/settings.json:

{
  "hooks": {
    "SessionEnd": [
      {
        "type": "command",
        "command": "luminaria"
      }
    ]
  }
}

License

MIT