Run only the tests a change can possibly break. Powered by GitLab Orbit.
The Problem: Organizations run thousands of tests for every merge request because they do not know which tests are actually affected by a change. Small code changes trigger massive CI workloads. Developers wait longer for feedback, companies spend millions on unnecessary compute, and CI infrastructure scales inefficiently.
The Solution: Crosscut acts as an autonomous, deterministic CI optimizer. When a developer opens a Merge Request, the Crosscut CLI analyzes the diff and extracts the changed symbols. It then queries the GitLab Orbit Knowledge Graph (via DuckDB) to traverse incoming call relationships. Crosscut discovers the exact transitive impact of the change, selects only the relevant test files, and dynamically generates a targeted child pipeline.
No LLMs, no hallucinations—just pure deterministic AST graph traversal.
Crosscut operates natively within the GitLab ecosystem and leverages the full power of Orbit:
- Language Agnostic: Because it relies on Orbit's native parsers, Crosscut works instantly on Python, TypeScript, Go, Java (e.g. Android repositories), and more!
- Diff Analysis: Intelligently identifies changed symbols directly from the Git diff.
- Orbit Traversal: Issues precise Query DSL to the local Orbit graph to find dependents.
- Automated Action: Outputs a targeted CI pipeline (
crosscut-targeted.yml) and an MR comment payload (crosscut-comment.md). - Cinematic Visualization: Next.js dashboard reads the CLI's exact JSON exhaust (
crosscut-results.json) to render a 100% authentic 3D representation of the impact graph using React Three Fiber.
Crosscut is built as a highly robust, production-ready tool:
- Backend: Python 3.12 pure CLI. Uses DuckDB to query Orbit locally, ensuring sub-second selection logic.
- Frontend: A stunning Next.js 15 dashboard featuring 3D interactive Orbit Reactors.
- Integration: 100% authentic data layer. The Next.js frontend strictly renders the exact
total_testsandselected_testscomputed by the Python backend in real-time.
You can point Crosscut at any local repository. First, index your repository with Orbit, then run Crosscut to generate the pipeline and results:
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
# Index your target codebase (can be ANY language Orbit supports!)
cd /path/to/your/repo
orbit index .
# Run Crosscut to analyze the latest commit
cd /path/to/Crosscut
crosscut --repo /path/to/your/repo --git-range "HEAD~1...HEAD" --out-json crosscut-results.jsonStart the visualizer to explore the exact JSON exhaust generated by the engine:
cd dashboard
npm install
npm run devVisit http://localhost:3000 to see the live 3D Orbit Reactor visualize the transitive impact of your commit! If you re-run the CLI against a different repository (like a large Java codebase), simply refresh the dashboard to see the new data rendered instantly!
This project is licensed under the MIT License - see the LICENSE file for details.