Eru.Tool 0.16.1

<p align="center"> <img src="docs/images/eru-logo.svg" alt="eru" width="280"> </p>

<h3 align="center">Targeted context for AI agents, from any git repo.</h3>

<p align="center"> <code>eru</code> pulls just the knowledge an agent needs from local or remote git sources, makes it searchable, gives humans a themed site to read it, and lets agents turn a pile of raw notes into a curated knowledge source. </p>

<p align="center"> <a href="https://github.com/dburriss/eru/actions/workflows/build.yml"><img src="https://github.com/dburriss/eru/actions/workflows/build.yml/badge.svg" alt="Build and test"></a> <a href="https://www.nuget.org/packages/Eru.Tool"><img src="https://img.shields.io/nuget/v/Eru.Tool?logo=nuget" alt="NuGet"></a> <a href="https://github.com/dburriss/eru/releases"><img src="https://img.shields.io/github/v/release/dburriss/eru?logo=github" alt="GitHub release"></a> </p>

<p align="center"> <img src="docs/reference/images/themes/terminal-dark.png" alt="The eru generated site in the terminal theme, dark mode" width="900"> <br> _{The generated site in the <code>terminal</code> theme. See all <a href="docs/reference/theme-list.md">themes</a>.} </p>

Get started

Install the tool (.NET 10 and git required; self-contained binaries are on the releases page):

dotnet tool install --global Eru.Tool

Or install a self-contained binary with mise, which needs neither .NET nor a separate download:

mise use --global github:dburriss/eru

Install the skill with skills.sh:

npx skills add dburriss/eru

Then ask your agent to set eru up. The skill knows how to add sources, pull files, build a site and run an inbox, so you don't need to learn the commands.

What it does

Targeted context for agents

Point eru at one or more git repos, local or remote, and pull only what a project needs: single files, named collections, or everything with a tag. Every pulled file is recorded in a lock file, so it stays in sync and you can see where it came from.

Search is powered by Ferret: ranked lexical (BM25), semantic and hybrid search, running locally over your knowledge. eru mcp exposes that search and retrieval to Claude, Copilot, Cursor and any other MCP client, so agents ask for context instead of reading whole repos.

• Getting started
• Pull files and collections
• Search reference
• Set up the MCP server

OKF or an eru manifest

A knowledge source can be an OKF bundle, or any repo with an eru .eru/manifest.json that declares the files it offers. eru can validate and repair OKF trees, and check that a manifest resolves.

• Set up a knowledge repo
• Publish a manifest
• Concepts

A site for humans

eru site generate builds a self-contained, searchable site from your knowledge, with five built-in themes and room for your own. eru site serve adds live reload, and the output publishes straight to GitHub Pages.

• Site generation reference
• Theme list
• Customize the generated site
• Publish to GitHub Pages

Agent workflows: from inbox to curated knowledge

Drop raw text into an inbox, which can be a local folder or a remote git repo. An ingestor agent processes each item into well-formed, linked, validated notes in your knowledge source. Run it locally while you work, or in CI so that pushing a raw capture is enough.

• Use send and watch locally
• Process the inbox with a GitHub Agentic Workflow
• Process the inbox with a plain GitHub Action

How it fits together

 git repos (local / remote)         inbox (raw text)
   OKF bundle or eru manifest             │
            │                             ▼
            │                     ingestor agent ──▶ curated knowledge
            ▼                                              │
   eru cache + lock file ◀─────────────────────────────────┘
            │
      ┌─────┴───────────────┐
      ▼                     ▼
 agents (search, MCP)   humans (generated site)

Documentation

Full documentation lives under docs/, organised by Diataxis: tutorials, how-to guides, reference and explanation. The complete command list is in the CLI reference.

Contributing

Run mise install for the toolchain, then dotnet build and dotnet test --solution eru.slnx. CI builds and tests every push and PR; pushing a v* tag publishes the NuGet package and GitHub release binaries. See AGENTS.md for the project layout, conventions and release flow.

License

MIT