kargnas - Commit AI (source v0.2.2)

VS Code extension to generate Git commit messages via OpenRouter.

Features

• One button next to the star in SCM input box
• Context-rich prompt (branch, staged name-status, staged patch, recent commits)
• Project tree renders as an indented tree with clear status chips (e.g., [Modified], [New])
• Include/ignore globs, size caps per file and total
• Lists up to 10 prior commit titles per touched file (configurable)
• Captures open editor tabs, recent integrated terminal output, and large file snapshots when a file has 3+ staged hunks
• Stage-all confirm when no staged changes
• Multi-repo workspaces supported; the command sticks to the repo you trigger it from and prompts if ambiguous
• OpenRouter chat/completions by default, Responses Alpha compatible
• Output channel logs + 'Show Last Payload' for debugging
• Local fallback if AI response is empty
• Commit body bullets are terse fragments like env template cleanup for fast scanning

Build

• Install: code --install-extension output/<generated>.vsix after packing.
• Pack: zip this folder as VSIX layout (put under extension/ folder) or run vsce package --out output/<name>.vsix.
• Remember to include meta.json when creating a .vsix per team convention.
• Dev shortcut: npm run package:install → bumps version, writes output/*.vsix, then installs it locally.

Dev convenience commands

• npm run package:install: packages via vsce into output/ then force-installs the generated VSIX into your local VS Code.
• npx vsce package --no-yarn --out output/<name>.vsix: quick manual package step if you just want the VSIX artifact.
• code --install-extension <vsix-path> --force: install a built VSIX (useful if you copied it elsewhere).
• code --uninstall-extension kargnas.kargnas-commit-ai: remove the installed copy before reinstalling from marketplace or another build.

Context Pipeline

• 자동으로 리포 메타/브랜치 힌트/파일 요약/프로젝트 트리를 수집해 LLM에 JSON 구조로 전달합니다.
• 모델 응답은 {type, scope, subject, body, breaking_change, issues, rationale} JSON으로 파싱되어 커밋 메시지를 구성합니다.

Commit Body Style

• Body array entries use succinct fragments such as env routing cleanup or api baseurl addition.
• Keep each fragment within 12 words, omit punctuation, and mention the touched artifact/key/value.
• Finish fragments with action nouns like cleanup, addition, removal, or sync for quick scanning.
• The kargnasCommitAI.commitLanguage setting still governs localization for these fragments (legacy karsCommitAI.* keys keep working but show as deprecated).

Settings (examples)

{
  "kargnasCommitAI.apiKey": "sk-or-...",
  "kargnasCommitAI.model": "google/gemini-2.5-flash-lite",
  "kargnasCommitAI.endpoint": "https://openrouter.ai/api/v1/chat/completions",
  "kargnasCommitAI.endpointRewrite": true,
  "kargnasCommitAI.transport": "fetch",
  "kargnasCommitAI.commitLanguage": "ko",
  "kargnasCommitAI.logPromptMaxChars": 0
}

기존 karsCommitAI.* 키는 그대로 작동하지만 VS Code에서 사용 중단 경고가 뜬다.

🆕 New Settings

• kargnasCommitAI.commitLanguage (default: "auto")
  • Subject/body language preference for generated commits. Keep as "auto" for English, or supply locale codes like "ko", "ja", "en-US".
• kargnasCommitAI.logPromptMaxChars (default: 0)
  • 0 = unlimited (logs entire prompt - useful for debugging)
  • > 0 = truncates prompt log to N characters
  • 프롬프트 전체를 보고 싶으면 0으로 설정하세요!