Ashlr Core Efficiency — Development skill for Claude Code

@ashlr/core-efficiency

Token-efficiency primitives for AI coding agents — genome RAG, multi-tier context compression, provider-aware budgeting, and prompt-caching helpers.

Extracted from [ashlrcode](https://github.com/ashlrai/ashlrcode) and shared by the `ashlrcode` CLI and the [ashlr-plugin](https://github.com/ashlrai/ashlr-plugin) for Claude Code.

**Platform support:** macOS / Linux / Windows on Bun >= 1.0 and Node >= 20.

---

Modules

Subpath	LOC	Purpose
`/genome`	~2,342	Self-evolving project specs via RAG + scribe protocol. Manifest CRUD, TF-IDF/Ollama retrieval, fitness-based strategy evolution, mutation audit trail.
`/compression`	~470	3-tier context compression: autoCompact (LLM summarize old turns), snipCompact (truncate tool results > 2 KB), contextCollapse (drop short/dup). PromptPriority enum.
`/budget`	~50	Provider-aware prompt budgeting. getProviderContextLimit, systemPromptBudget.
`/tokens`	~50	Token estimation: estimateTokensFromString, estimateTokensFromMessages.
`/anthropic`	~200	Anthropic SDK helpers: withGenome, cacheBreakpoints, ashlrMcpConfig.
`/session-log`	~150	Structured session event log (tool calls, costs, savings).
`/local`	~120	Context-window manager for small-context local models.
`/types`	~60	Shared types: Message, ContentBlock, LLMSummarizer, StreamEvent.

---

Install

# Bun (primary runtime)
bun add @ashlr/core-efficiency

# npm / pnpm / yarn
npm install @ashlr/core-efficiency

For local development against a checkout:

bun add file:../ashlr-core-efficiency

The package ships TypeScript source in `src/`. Bun runs it directly. For Node.js, compile first with `bun run build` (outputs to `dist/`).

---

Quickstart

compression

``