What is neo4j-ruby-driver CLAUDE.md?

Project instructions for the Neo4j Ruby Driver, a Ruby library that connects programs to Neo4j graph databases. They describe its branches, the Bolt and PackStream protocols, and related official drivers used for comparison.

Use them when developing or reviewing the Ruby driver, comparing its MRI and JRuby implementations, or checking Bolt protocol behavior.

They give contributors the project’s branch rules and technical references when changing the driver. They also explain which implementation to consult when behavior is unclear.

How neo4jrb/neo4j-ruby-driver configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to neo4jrb/neo4j-ruby-driver. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/neo4jrb/neo4j-ruby-driver/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/neo4jrb/neo4j-ruby-driver

Made for: Claude Code.

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/neo4jrb/neo4j-ruby-driver/claude-md/github.svg)](https://agentmods.dev/instructions/neo4jrb/neo4j-ruby-driver/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/neo4jrb/neo4j-ruby-driver/claude-md"><img src="https://agentmods.dev/badge/instructions/neo4jrb/neo4j-ruby-driver/claude-md/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/neo4jrb/neo4j-ruby-driver/claude-md"><img src="https://agentmods.dev/badge/instructions/neo4jrb/neo4j-ruby-driver/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 1,518 This file is loaded in full into every session.

When invoked 1,518 The same file — it is already loaded in full.

Security scan A 0 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.

Model	Per session	Once invoked
Fable 5.1	$0.01518	$0.01518
Opus 5.5	$0.00607	$0.00607
Sonnet 5.5	$0.00304	$0.00304
Haiku 4.5	$0.00152	$0.00152

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

Security

Grade A, and why

neo4j-ruby-driver CLAUDE.md scanned grade A with 0 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 2mo 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 102 lines

How it starts

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

Neo4j Ruby Driver

Branches

main is the active development branch — base feature branches on it and target PRs at it. 4.4 is a diverged, older release line (it predates the JRuby/shared split and the auth-manager work); don't branch off it.

Essential References

Specifications

Bolt Protocol: https://neo4j.com/docs/bolt/current/
PackStream: https://neo4j.com/docs/bolt/current/packstream/

Official Drivers (for comparison)

Java (reference impl): https://github.com/neo4j/neo4j-java-driver and https://github.com/neo4j/bolt-connection-java
Python: https://github.com/neo4j/neo4j-python-driver
JavaScript: https://github.com/neo4j/neo4j-javascript-driver
Go: https://github.com/neo4j/neo4j-go-driver

When in doubt, check the Java driver - it's the most comprehensive reference implementation.

Two implementations behind one public API: the MRI impl is a pure-Ruby implementation of the Neo4j Bolt protocol (no Java dependency); the JRuby impl wraps the official Java driver. When in doubt about driver semantics, the Java driver is the reference: https://github.com/neo4j/neo4j-java-driver

See DEVELOPMENT.md for dev-loop commands and DECISIONS.md for the dated log of architectural choices.

Layout

Dev tree is split into lib/{shared,mri,jruby}/. The published gem is flattened to lib/ via a staged build (Pattern 1 — see JRUBY.md).

lib/shared/neo4j/driver.rb        Gem entry (Zeitwerk setup; pushes shared + impl roots)
lib/mri/neo4j/driver/             MRI implementation
  bolt/                           Bolt protocol: connection, messages
  packstream/                     Binary serialization: packer/unpacker
  types/                          Neo4j types (Node, Relationship, Path, temporal, Point, Duration)
  exceptions/                     Exception hierarchy, one class per file
  session.rb                      Session + auto-commit
  transaction.rb                  Explicit transactions
  result.rb                       Streaming result
  record.rb / summary.rb
lib/jruby/neo4j/driver/           JRuby implementation: thin wrapper over the
                                  Java driver (org.neo4j.driver jars). `ext/`
                                  mixins are prepended onto the Java classes
                                  for Ruby<->Java type/exception conversion.

Read the full file on GitHub · 102 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.

2mo ago First seen · 102 lines · 1,518 tokens per session scan A 27cb9ee3d9ad

Subscribe to this mod's changes

neo4j-ruby-driver CLAUDE.md is an instructions file published in the GitHub repository neo4jrb/neo4j-ruby-driver (51 stars, last pushed 6d ago), licensed MIT. It adds 1,518 tokens to every session, about $0.0061 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Databases Languages Ruby

neo4j-ruby-driver CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
neo4j-ruby-driver CLAUDE.mdneo4jrb/neo4j-ruby-driver	Instructions file	51	6d ago	MIT	A	1,518	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

neo4j-ruby-driver: Instructions file for Claude Code