ladybugdb

ladybugdb is a skill for Claude Code, Codex from delexw/claude-code-misc. It costs 173 tokens per session (1,338 once invoked), scanned C, original, MIT.

A guide to LadybugDB, an embedded graph database that runs inside an application instead of as a separate server and uses openCypher queries.

In plain words
What is it for?
Use it when working with LadybugDB through its command-line tool, Python package, or Node.js package, including creating schemas, importing data, and writing Cypher queries.
Why use it?
It explains the database's required table schema, storage and transaction rules, and differences that can affect how queries and writes behave.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when working with LadybugDB through its command-line tool, Python package, or Node.js package, including creating schemas, importing data, and writing Cypher queries.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/delexw/claude-code-misc/ladybugdb
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add delexw/claude-code-misc --skill ladybugdb
Clone the repo
git clone --depth 1 https://github.com/delexw/claude-code-misc

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ladybugdb

README.md
[![agentmods](https://agentmods.dev/badge/skills/delexw/claude-code-misc/ladybugdb/github.svg)](https://agentmods.dev/skills/delexw/claude-code-misc/ladybugdb)
Your own site
<a href="https://agentmods.dev/skills/delexw/claude-code-misc/ladybugdb"><img src="https://agentmods.dev/badge/skills/delexw/claude-code-misc/ladybugdb/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ladybugdb

Your own site · 80×15
<a href="https://agentmods.dev/skills/delexw/claude-code-misc/ladybugdb"><img src="https://agentmods.dev/badge/skills/delexw/claude-code-misc/ladybugdb.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 173 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,338 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 2 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00173 $0.01338
Opus 5.5 $0.00069 $0.00535
Sonnet 5.5 $0.00035 $0.00268
Haiku 4.5 $0.00017 $0.00134

Measured 1mo ago against content hash 39f0c4efd42a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

ladybugdb scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -s https://install.ladybugdb.com | bash # Linux

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s https://install.ladybugdb.com | bash # Linux
skills/ladybugdb/SKILL.md · 95 lines

How it starts

The opening of the file, as written. The whole thing — 95 lines — stays where its author put it; the contents beside it link to each section on GitHub.

LadybugDB

LadybugDB is an embedded, in-process property graph database — no server process required. It uses the openCypher query language with a required, predefined schema (unlike Neo4j), columnar disk-based storage, vectorized query execution, and serializable ACID transactions.

Quick orientation

  • Schema-first: you must create node/rel tables before inserting data
  • One primary key per node table — automatically indexed, unique, non-null
  • Walk semantics: repeated edges allowed in MATCH (unlike Neo4j's trail semantics)
  • One write transaction at a time; multiple concurrent reads are fine
  • In-memory mode: use ":memory:" as the database path for ephemeral databases

Installation

# CLI
curl -s https://install.ladybugdb.com | bash   # Linux
brew install ladybug                             # macOS

# Python
pip install real_ladybug

# Node.js
npm install @ladybugdb/core

CLI basics

lbug mydb.lbug        # open/create on-disk DB
lbug                   # in-memory (ephemeral)
lbug mydb.lbug < schema.cypher   # batch mode

Key shell commands: :schema (show tables), :help, :quit, :mode [json|csv|markdown|...]

Reference files

Load only the sections you need:

File Contents
references/cypher-reference.md DDL, DML, MATCH queries, transactions, macros, LadybugDB vs Neo4j differences
references/python.md Python (real_ladybug) — connection, query, DataFrame, transactions
references/nodejs.md Node.js (@ladybugdb/core) — connection, query, streaming, transactions
references/java.md Java — Maven setup, connection, query, transactions
references/rust.md Rust — Cargo setup, connection, query, Value types
references/go.md Go — module setup, connection, query, transactions
references/swift.md Swift — SPM setup, connection, query, async/await
references/import.md COPY FROM, LOAD FROM, DataFrame import, cloud storage, performance tips
references/export.md COPY TO, DataFrame export (pandas/polars/arrow), DuckDB export
references/graph-algorithms.md PageRank, Louvain, WCC, SCC, K-Core, shortest paths — PROJECT_GRAPH
references/vector-search.md HNSW index, CREATE/QUERY/DROP_VECTOR_INDEX, RAG pattern
references/full-text-search.md BM25, CREATE/QUERY/DROP_FTS_INDEX, stemmers
references/llm-embeddings.md CREATE_EMBEDDING — OpenAI, Ollama, Google, Bedrock, Voyage AI
references/attach.md ATTACH/DETACH — PostgreSQL, DuckDB, SQLite, Delta Lake, Iceberg, Neo4j
references/cli.md lbug shell flags, commands, output modes, batch/scripting mode
references/explorer.md Ladybug Explorer Docker GUI — launch, env vars, volume mount

Read the full file on GitHub · 95 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 95 lines · 173 tokens per session scan C 39f0c4efd42a

Subscribe to this mod's changes

ladybugdb is a skill published in the GitHub repository delexw/claude-code-misc (2 stars, last pushed 6mo ago), licensed MIT. It adds 173 tokens to every session and 1,338 once invoked, about $0.0007 per session on Opus 5.5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

doris-repo-review

Review an Apache Doris PR from a local clone with the same multi-agent, shared-ledger convergence workflow as the CI Code Review Runner. Use when the user supplies a PR to /doris-repo-review, asks to review a Doris PR locally, or asks for the CI-style review flow. Safely align only the current worktree to the exact PR…

apache/doris-skills · 180 tokens

doris-best-practices

Apache Doris table design and cluster sizing best practices. MUST USE when writing, reviewing, or optimizing Doris CREATE TABLE statements, partition/bucket strategies, data models, or cluster configurations. ALSO MUST USE whenever the doris-architecture-advisor skill produces DDL — apply the Pre-Flight Checklist to…

apache/doris-skills · 256 tokens

doris-architecture-advisor

Workload-aware architecture design for Apache Doris. MUST USE when designing data architectures, choosing between data models, planning ingestion strategies, sizing clusters, or translating business requirements into Apache Doris system designs. Complements doris-best-practices with decision frameworks and…

apache/doris-skills · 279 tokens

doris-debug-cloud

Use for Doris storage-compute separation (cloud mode) issues: meta-service latency, cache miss storms, object store throughput, and shared-nothing config conflicts in compute groups.

apache/doris-skills · 40 tokens

doris-debug-resource-isolation

Use for Doris Workload Group / resource tag queue starvation, CPU/memory isolation leaks, and workload policy debugging. Commands: SHOW WORKLOAD GROUPS, EXPLAIN resource.

apache/doris-skills · 43 tokens

doris-debug-compaction

Use for Doris -235 / too many versions and compaction lag. Error raised in RowsetBuilder::checktabletversioncount when versioncount > maxtabletversionnum (default 2000) or meta serialize size limit.

apache/doris-skills · 53 tokens