Wisegit FAQs

Name: Wisegit
Author: Sandip124

Question 1

What is Wisegit and its primary purpose?

Accepted Answer

Wisegit is a local developer tool that extracts decision intent from your git history using AST-level parsing. Its primary purpose is to generate 'decision manifests' that protect intentional code from being unintentionally modified by AI agents like Claude Code, by classifying functions as FROZEN, STABLE, or OPEN.

Question 2

How does Wisegit prevent AI from modifying intentional code?

Accepted Answer

Before an AI agent edits a file, Wisegit injects a decision manifest. This manifest clearly labels functions based on their 'freeze score' derived from git signals, issue context, and code structure. The AI is then instructed to respect these classifications, preventing it from altering FROZEN code without explicit approval.

Question 3

What are the prerequisites and how do I get started with Wisegit?

Accepted Answer

Wisegit requires Node.js >= 20. It's zero-config and local; no Docker or external services are needed. To get started, navigate to your repository and run `npx @sandip124/wisegit setup`. This command indexes your git history and configures your repo for AI integration.

Question 4

Does Wisegit integrate with external issue trackers or LLMs?

Accepted Answer

Yes, Wisegit can enrich code intent by fetching issue/PR details from GitHub/GitLab, boosting freeze scores for related functions. It also supports LLM-based intent extraction for 'noise' commits, either by leveraging the host LLM (like Claude) when used inside compatible IDEs, or locally via Ollama.

Question 5

What do FROZEN, STABLE, and OPEN classifications mean for my code?

Accepted Answer

FROZEN functions (score >= 0.80) should not be modified without explicit user approval due to high intentionality. STABLE functions (score 0.50-0.79) require caution and review of intent. OPEN functions (score < 0.50) are considered safe for free modification by AI, as there's less explicit intent protection.

Wisegit

Wisegit

Key Features

Use Cases

Key Features

Use Cases