sephera 0.5.0

Local-first Rust CLI for repository metrics and deterministic LLM context packs with AST compression and MCP.
Documentation

Sephera

Sephera is a local-first Rust CLI for two jobs that are usually split across separate tools:

  • repository metrics
  • deterministic context export

It currently focuses on three practical commands:

  • loc: fast, language-aware line counting across project trees
  • context: deterministic Markdown or JSON bundles with AST compression
  • mcp: built-in MCP server for direct AI agent integration

Sephera is intentionally narrow in scope. It does not try to be an agent runtime, a hosted service, or a provider-specific AI wrapper.

Install

cargo install sephera

Quick examples

Count lines of code in the current repository:

sephera loc --path .

Build a focused context pack and export it to JSON:

sephera context --path . --focus crates/sephera_core --format json --output reports/context.json

Compress context excerpts to reduce token usage (supports 8 languages):

sephera context --path . --compress signatures --budget 64k

Start MCP server for AI agent integration:

sephera mcp

Build a review-focused pack from Git changes:

sephera context --path . --diff HEAD~1 --budget 32k

List configured profiles for the current repository:

sephera context --path . --list-profiles

Why not cloc or tokei?

If you only need line counts, cloc and tokei are excellent tools and already solve that job well.

Sephera is useful when you need more than raw totals:

  • loc is only one half of the workflow
  • context turns repository structure into deterministic Markdown or JSON bundles
  • context --diff can center those bundles on a branch, commit, or current working tree
  • .sephera.toml lets teams keep shared context defaults and named profiles in the repository
  • AST compression reduces token usage by 50-70% while preserving API surface
  • focus paths and approximate token budgets make output more practical for LLM use
  • sephera mcp provides direct integration with AI agents like Claude Desktop

The goal is not to replace every code metrics tool. The goal is to pair trustworthy repository signals with context export that is actually usable in modern review and AI-assisted workflows.

Learn more