documentation

GitSense Documentation

GitSense is an AI-native repository intelligence platform. It analyses architecture, dependencies, contributors, security risks, and overall health of any repository — purpose-built for decentralized ecosystems like Gitlawb.

These docs are intentionally minimal during early access. They cover the fundamentals you need to scan your first repository and understand what GitSense returns.

Quick Start

Get your first analysis in under a minute. Open the live analyzer on the landing page, drop in any Gitlawb URL, and GitSense will return a full intelligence brief — no installation, no auth.

01Open the GitSense landing page and scroll to the live analyzer.
02Paste a Gitlawb repository URL — e.g. gitlawb://gitsense/repository-demo.
03Press Analyze and watch the six-stage AI scan run end-to-end.
04Review repo health, dependencies, contributors, security risks, and AI recommendations.

bash

# coming soon
gitsense scan gitlawb://gitsense/repository-demo

Repository Analysis

Every scan produces a structured report with five primary surfaces. Each surface is generated by a dedicated AI agent operating in parallel.

Health score

Composite 0–100 score weighing docs, tests, security, and ecosystem signals.

Architecture summary

Natural-language overview of the codebase shape, module boundaries, and patterns.

Dependency graph

Direct + transitive dependencies with risk tier and version drift.

Contributor insights

Activity, ownership heatmaps, and bus factor across the repo.

Security risks

CVE matches, secret detection, and config issues ranked by severity.

AI recommendations

Concrete remediations and refactors prioritized by impact.

API

A public REST API is in private preview. The endpoints below mirror the shape of the in-app analyzer and will be available with API keys at GA.

http

POST /api/analyze
Content-Type: application/json

{
  "repo_url": "gitlawb://gitsense/repository-demo"
}

json

{
  "repo_name": "gitsense/repository-demo",
  "health_score": 87,
  "files_analyzed": 1247,
  "dependencies": [...],
  "contributors": [...],
  "security_risks": [...],
  "ai_recommendations": [...]
}

Authenticated API keys, webhooks, and SDKs (TypeScript, Python, Rust) are on the roadmap. Subscribe to release notes for availability.

Gitlawb Integration

GitSense was built natively for decentralized repositories. The Gitlawb integration lets you paste any gitlawb:// URL and receive a complete intelligence brief — no host accounts, no centralized indexes.

Native URL support

Drop a gitlawb:// URL anywhere in GitSense — the live analyzer, API, or CLI (soon).

Decentralized-first

No proprietary metadata required. GitSense reads what the Gitlawb network exposes.

In progress