Welcome to Calyntro’s documentation!

Calyntro is a repository intelligence platform that derives structural and behavioural insights from Git history — without instrumentation, build integration, or access to runtime data.

It is built around four operational questions that matter at the architecture and engineering-management level:

• Where are the risks? The Code Map and Scatter Analysis make structural risk visible across the entire module landscape in a single view — surfacing which components are simultaneously complex, actively changing, and poorly understood.

• How are trends developing? The Trend Analysis tracks Cognitive Complexity, Lines of Code, Silo Ratio, and commit activity per module over configurable time windows — turning point-in-time snapshots into directional signals.

• What needs attention now? The Dashboard Warnings panel surfaces the top prioritised risks (hotspots, knowledge silos, complexity spikes, churn outliers, reactivated legacy code) with normalised scores and direct navigation to the relevant analysis view.

• Who holds critical knowledge? The Knowledge Risk screen breaks down Bus Factor exposure to the developer and file level — showing which modules depend on a single person, which files carry the highest weighted risk, and how knowledge concentration has evolved over time.

Calyntro derives all metrics exclusively from commit history: author dates, changed lines, file paths, and commit hashes. No static analysis agents, no test runners, no issue tracker connections are required. A repository import takes minutes; the analysis runs on an embedded DuckDB instance with no external database dependencies.

The platform is designed for Software Architects who need to identify refactoring priorities, Engineering Managers who need to assess team knowledge distribution and Bus Factor risk, and CTOs who need a continuous, objective signal on codebase health without relying on self-reporting.

Check out the Dashboard User Guide section for further information, including how to install the project.

Note

This project is under active development

Contents:

• Installation Guide
  • Prerequisites
  • Getting the Deployment Files
  • Next Steps
• Setup & Update Guide
  • Initial Setup
  • Update Process (Operation)
• Dashboard User Guide
  • Navigation & Filtering
  • Views
• Dashboard Overview
  • KPI Cards
  • Trend Sparklines
  • Warnings Panel
  • Repository Insights
  • API Endpoints
• Knowledge Risk
  • KPI Cards
  • Modules by Risk
  • Key Persons — Exclusive Knowledge
  • Most At-Risk Files
  • Silo Ratio Over Time
  • API Endpoints
  • Relationship to the Dashboard
• API Reference
  • Common Concepts
  • Repository & Files
  • Lines of Code (LOC)
  • Evolution & Pulse
  • Quality & Risk
  • Structure & Logic
  • Team & Knowledge
  • Dashboard KPIs
  • Configuration
• Understanding Calyntro Analyses
  • Analysis Scopes
  • Evolution & Pulse (Activity)
  • Quality & Risk
  • Structure & Logic (Complexity)
  • Team & Knowledge (Ownership)
  • Base Metrics
  • Visual Analysis Views (Module Scope)

License

Calyntro is released under the terms specified in the LICENSE file.

Terms of Use & Disclaimer

Calyntro is distributed as free-to-use Docker containers.
You are welcome to deploy and use the provided images for your own projects.

Disclaimer of Warranty:
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
USE AT YOUR OWN RISK.