barry-cache

library0.6.1jsnpmunverified

Barry Cache (v0.6.1, active development) is an agent-agnostic, source-backed context management tool for coding agents. It creates, validates, and serves deterministic project context slices, ensuring agents load the smallest relevant knowledge from a repo. Unlike ad-hoc chat history or vendor-specific instructions, Barry Cache stores canonical facts in docs/context/, operational state in .context-state/, and generated retrieval data in .context-cache/. Key features: agent-agnostic adapters (Codex, Copilot, Cursor, Claude, Gemini, llms.txt), stable fact IDs with source references, and context-efficient routing via route, search, load, and resume commands. Requires Node.js >=20; released weekly.

devops

npm install barry-cache

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · BARRY-CACHE

barry-cache

devopsjavascriptv0.6.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

barry-cache

✓ npx barry-cache <command>

✗ npm install barry-cache -g && barry-cache

Primarily used via npx; there is no package import — it's a CLI tool.

Initializes Barry Cache in a repo with default settings and only Codex adapter, non-interactively.

npx barry-cache init --yes --agents codex

Debug

Known issues

breakingNode.js version requirement: >=20. Older versions will fail with syntax errors.

fix

Update Node.js to v20 or later.

affects: >=0.0.0

gotchaThe init command creates files and modifies .gitignore; dry-run is recommended for preview.

fix

Use 'npx barry-cache init --dry-run' first.

affects: >=0.0.0

gotchaContext files must follow strict schema; invalid files will be reported by validate/doctor.

fix

Run 'npx barry-cache validate' after editing context files.

affects: >=0.0.0

Errors

Common errors & fixes

SyntaxError: Unexpected token '.'

Node.js version <20 is used, which lacks support for newer JS syntax (e.g., optional chaining).

fix

Upgrade Node.js to v20 or later.

ENOENT: no such file or directory, open 'docs/context/features/...'

Barry Cache has not been initialized in the repository; context directory is missing.

fix

Run 'npx barry-cache init' first.

Upgrade

Version history

0.6.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/AlexanderIstomin/barry-cache ↗

packagebarry-cache ↗

homepagehttps://github.com/AlexanderIstomin/barry-cache#readme ↗