How should commit-smith be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this mcp.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

commit-smith answer-first brief

MCP server that provides AI tools for generating conventional commit messages from git diffs CommitSmith 🛠️ **Simplified MCP Server for AI-powered Commit Generation** CommitSmith is a Model Context Protocol (MCP) server that provides AI assistants with a single intelligent tool to generate high-quality conventional commit messages. Instead of generating commits itself, it empowers AI assistants like Claude to understand your code changes and craft perfect commit messages according to your preferences throug Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Freshness

Last checked 2/22/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

commit-smith is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierGitHubSafety: 89/100

commit-smith

MCPverified

Public facts

Change events

Artifacts

Freshness

Feb 22, 2026

Verifiededitorial-content1 verified compatibility signal

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Schema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 22, 2026

Vendor

Commit Smith

Artifacts

Benchmarks

Last release

0.1.0

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

View Source Homepage

Setup snapshot

git clone https://github.com/saoudi-h/commit-smith.git

1
Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

Commit Smith

profilemedium

Observed Feb 24, 2026Source link Provenance

Compatibility (2)

Protocol compatibility

MCP

contracthigh

Observed Feb 24, 2026Source link Provenance

Auth modes

mcp, api_key

contracthigh

Observed Feb 24, 2026Source link Provenance

Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh

Observed Feb 24, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

Examples

Snippets

Languages

typescript

Executable Examples

bash

# Via npm
npm install -g commit-smith

# Via Docker
docker pull commitsmith/commit-smith

# From source
git clone https://github.com/commit-smith/commit-smith.git
cd commit-smith
pnpm install && pnpm build

json

{
  "mcpServers": {
    "commit-smith": {
      "command": "commit-smith",
      "args": []
    }
  }
}

bash

git add .

text

"Generate a short commit message for my changes"

text

"Create a detailed commit and commit it automatically"

typescript

{
  request: string,        // Natural language description of desired commit
  auto_commit?: boolean,  // Whether to auto-commit (default: true)
  auto_stage?: boolean   // Whether to stage unstaged files (default: true)
}

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

Full README

CommitSmith 🛠️

Simplified MCP Server for AI-powered Commit Generation

CommitSmith is a Model Context Protocol (MCP) server that provides AI assistants with a single intelligent tool to generate high-quality conventional commit messages. Instead of generating commits itself, it empowers AI assistants like Claude to understand your code changes and craft perfect commit messages according to your preferences through natural language requests.

🌟 What makes CommitSmith different?

True MCP Architecture: Provides tools for AI, doesn't replace AI
Single Intelligent Tool: Natural language requests determine behavior automatically
Smart Auto-Handling: Intelligently manages unstaged files with confirmation flow
Streamlined: Focused on commit message generation without unnecessary complexity
IDE Integration: Works with VS Code, vim, emacs, and any git-enabled editor
Flexible Workflows: Interactive, prepare-for-review, or auto-commit modes

🚀 Quick Start

Installation

# Via npm
npm install -g commit-smith

# Via Docker
docker pull commitsmith/commit-smith

# From source
git clone https://github.com/commit-smith/commit-smith.git
cd commit-smith
pnpm install && pnpm build

Basic Usage with Claude

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "commit-smith": {
      "command": "commit-smith",
      "args": []
    }
  }
}

Stage your changes (optional - CommitSmith can handle unstaged files):

git add .

Ask Claude with natural language:

"Generate a short commit message for my changes"

Or for more complex requests:

"Create a detailed commit and commit it automatically"

Claude will automatically:

Analyze your changes (staged and unstaged)
Parse your natural language request to determine commit style
Handle unstaged files intelligently (auto-stage or ask for confirmation)
Generate a perfect conventional commit message
Validate the message against conventional commit rules
Prepare the message in .git/COMMIT_EDITMSG for review
Optionally auto-commit when requested

🎯 Natural Language Examples

Basic Requests

"Generate a commit message for my changes"
"Create a short commit message"
"Make a detailed commit for my work"

Style-Specific Requests

"Generate a minimal commit message" (single line only)
"Create a strict commit with proper validation" (enterprise-grade)
"Make a descriptive commit with context" (detailed explanations)

Auto-Commit Requests

"Generate a commit and commit it automatically"
"Create a short commit and commit it"
"Auto-commit my detailed changes"

Unstaged File Handling

"Generate a commit for my changes" (auto-stages unstaged files)
"Create a commit without staging files" (asks for confirmation)

🛠️ The Single `commit` Tool

Schema

{
  request: string,        // Natural language description of desired commit
  auto_commit?: boolean,  // Whether to auto-commit (default: true)
  auto_stage?: boolean   // Whether to stage unstaged files (default: true)
}

Parameters

request (required): Natural language description of what you want
- Examples: "Generate a short commit message", "Create a detailed commit and commit it"
- The AI automatically determines commit style, auto-commit behavior, and staging preferences
auto_commit (optional, default: true): Whether to automatically commit after preparing the message
- Set to true for fully automated workflows (default behavior)
- Set to false for manual review in your IDE
auto_stage (optional, default: true): Whether to automatically stage unstaged files
- Set to true to automatically include all unstaged changes
- Set to false to get a confirmation request with file list

Behavior

Smart Natural Language Processing

The tool parses your request to automatically determine:

Commit Style: short, detailed, strict, or default
Auto-commit: Whether to commit automatically or prepare for review
Auto-staging: Whether to stage unstaged files or ask for confirmation

Unstaged File Handling

When auto_stage: true: Automatically stages all unstaged files
When auto_stage: false: Returns a confirmation request with the list of unstaged files
No staged changes: Returns an error if no changes are found

Validation and Preparation

Validates generated messages using conventional commit rules
Prepares valid messages in .git/COMMIT_EDITMSG for IDE review
Provides detailed error messages for invalid commits

📚 Resources for AI

commit://agent-definition - Complete AI behavior prompt
commit://presets - Available agent presets for different commit styles

💡 Usage Patterns

Interactive Review (Recommended)

User: "Generate a short commit message for my changes"

AI:
1. Analyzes staged and unstaged changes
2. Parses "short" request → uses minimal style
3. Generates single-line commit message
4. Validates against conventional commit rules
5. prepare_commit_message → ready for your review
6. "Message prepared in .git/COMMIT_EDITMSG - review in your IDE!"

Auto-Commit

User: "Create a detailed commit and commit it automatically"

AI:
1. Analyzes all changes
2. Parses "detailed" and "commit it" → uses descriptive style + auto_commit
3. Generates detailed commit message with body
4. Validates message
5. prepare_commit_message
6. commit_with_message → executes the commit
7. "Committed successfully: abc123"

Confirmation Flow for Unstaged Files

User: "Generate a commit without staging files"

AI:
1. Detects unstaged files
2. Returns confirmation request:
   {
     "needs_confirmation": true,
     "message": "Found 3 unstaged files. Please confirm if you want to stage them:",
     "unstaged_files": ["file1.js", "file2.js", "file3.js"],
     "suggestion": "You can call the commit tool again with auto_stage: true to automatically stage these files."
   }

🔗 IDE Integration

VS Code

AI generates message via commit tool
Open Source Control panel
Message is pre-filled in the commit message editor
Edit if needed and click Commit

Command Line

# After commit tool prepares message
git commit -e  # Opens editor with pre-filled message

JetBrains IDEs / Vim / Emacs

Works with any IDE that reads .git/COMMIT_EDITMSG

📖 Advanced Examples

Complex Natural Language Requests

User: "I made significant changes to the authentication system, 
       including JWT validation, refresh tokens, and error handling. 
       Create a strict commit and commit it automatically"

AI:
1. Parses "strict" → uses strict preset (enterprise-grade)
2. Parses "commit it automatically" → sets auto_commit: true
3. Generates detailed commit message with exactly 2-3 bullet points
4. Validates against strict rules
5. Auto-commits the changes

Error Handling

User: "Generate a commit message"

AI (if validation fails):
{
  "success": false,
  "validation_errors": [...],
  "formatted_errors": "Subject must be under 50 characters",
  "suggestion": "The generated commit message doesn't meet the validation requirements. Please try a different approach."
}

🧪 Development

Setup

git clone https://github.com/commit-smith/commit-smith.git
cd commit-smith
pnpm install

Testing

pnpm test              # Run all tests
pnpm run test:watch    # Watch mode
pnpm run test:coverage # Coverage report

Building

pnpm build         # Compile TypeScript
pnpm run dev           # Development mode

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Setup

Fork the repository
Create a feature branch
Make your changes
Add tests
Submit a pull request

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Built with the Model Context Protocol SDK
Inspired by Conventional Commits
Git operations powered by simple-git

🔗 Links

Made with ❤️ for developers who care about commit quality

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

Yes

Data region

global

Protocol support

MCP: verified

Requires: mcp, lang:typescript, streaming

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.

Trust confidence is not low and verification freshness is acceptable.

Protocol support is explicitly confirmed in contract metadata.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/snapshot"

curl -s "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/contract"

curl -s "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

GITLAB_AI_CATALOGgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_PUBLIC_PROJECTSgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-openapi

Rank

Expose OpenAPI definition endpoints as MCP tools using the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-actix-web

Rank

An actix_web backend for the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "lang:typescript",
    "streaming"
  ],
  "forbidden": [],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": true,
  "inputSchemaRef": "https://github.com/saoudi-h/commit-smith#input",
  "outputSchemaRef": "https://github.com/saoudi-h/commit-smith#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:46:12.684Z",
  "sourceUpdatedAt": "2026-02-24T19:46:12.684Z",
  "freshnessSeconds": 4428443
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-04-17T01:53:36.460Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "mcp",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "mcp-server",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "git",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "commit",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "conventional-commits",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "ai",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "claude",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "automation",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "development-tools",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "cli",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract capability:mcp|supported|profile capability:mcp-server|supported|profile capability:git|supported|profile capability:commit|supported|profile capability:conventional-commits|supported|profile capability:ai|supported|profile capability:claude|supported|profile capability:automation|supported|profile capability:development-tools|supported|profile capability:cli|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:12.684Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:12.684Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/saoudi-h/commit-smith#input",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:12.684Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Commit Smith",
    "href": "https://github.com/commit-smith/commit-smith#readme",
    "sourceUrl": "https://github.com/commit-smith/commit-smith#readme",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-saoudi-h-commit-smith/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

commit-smith answer-first brief

Executive Summary

Evidence Ledger

Release & Crawl Timeline

Artifacts Archive

Docs & README

CommitSmith 🛠️

🌟 What makes CommitSmith different?

🚀 Quick Start

Installation

Basic Usage with Claude

🎯 Natural Language Examples

Basic Requests

Style-Specific Requests

Auto-Commit Requests

Unstaged File Handling

🛠️ The Single commit Tool

Schema

Parameters

Behavior

Smart Natural Language Processing

Unstaged File Handling

Validation and Preparation

📚 Resources for AI

💡 Usage Patterns

Interactive Review (Recommended)

Auto-Commit

Confirmation Flow for Unstaged Files

🔗 IDE Integration

VS Code

Command Line

JetBrains IDEs / Vim / Emacs

📖 Advanced Examples

Complex Natural Language Requests

Error Handling

🧪 Development

Setup

Testing

Building

🤝 Contributing

Development Setup

📄 License

🙏 Acknowledgments

🔗 Links

Contract & API

Reliability & Benchmarks

Media & Demo

Related Agents

🛠️ The Single `commit` Tool