Reim-developer/Sephera

View on GitHub ↗

Fast local-first Rust CLI for codebase metrics, AST-compressed LLM context bundles, and built-in MCP server.

75 ★9 forksRustUpdated 5mo ago

What you need to know

Narrow-scope Rust CLI + built-in MCP server for fast codebase understanding — language-aware LOC counting, deterministic AI-ready context packs (Markdown/JSON with AST compression ~50-70% token reduction, focus paths, git diff awareness, token budgets), dependency-graph analysis via Tree-sitter import extraction with reverse-dependency blast-radius queries, plus URL mode for remote repos.

Install

cargo install sephera (or prebuilt archives from GitHub Releases)
MCP: {"command":"sephera","args":["mcp"]} in Claude Desktop/Cursor config

Usage

  • •sephera loc --path . (or --url https://github.com/...); sephera context --path . --focus crates --format json --budget 32k --compress signatures
  • •sephera graph --path . --what-depends-on <file> --depth 1; --format markdown/dot; cycle detection
  • •sephera context --diff HEAD~1 --budget 32k for review packs; profiles via .sephera.toml; sephera mcp exposes loc/context/graph over stdio

Key features

  • ✓4 commands (loc/context/graph/mcp) exposing the same local engines through MCP without shell wrappers
  • ✓AST compression signatures/skeleton modes using Tree-sitter (Rust, Python, TS/JS, Go, Java, C++, C)
  • ✓URL mode: cloneable repo URLs + GitHub/GitLab tree URLs without cloning; --ref/tag/commit support
  • ✓review-friendly context centered on HEAD~1/origin/master; deterministic machine-readable output
  • ✓repo-level defaults (.sephera.toml), named profiles, CLI overrides; reproducible benchmarks, fuzz targets, generated language metadata
  • ✓dependency impact analysis with reverse deps, depth limits, exports (JSON/Markdown/XML/DOT)

Best for

Developers who want a fast, token-budgeted codebase context pack + blast-radius tracing using one binary and an agent integration.

Caveats

  • ⚠pre-1.0 (v0.5.0) — APIs may shift
  • ⚠GPLv3
  • ⚠Rust toolchain install or prebuilt releases; docs site Astro Starlight
  • ⚠intentionally narrow: no agent runtime/hosted service/embeddings
Platforms: macOS · Linux · WindowsClients: Claude Desktop · Cursor · generic MCP clients

Reviewed 2026-08-11

Topics

clicommand-line-toolcontext-engineeringdeveloper-toolsllmllm-agentsmcpmodel-context-protocolrusttree-sitter
Stars
75★
Forks
9
Language
Rust
License
GPL-3.0
Created
2025-04-11
Last push
2026-04-04