commitbee 0.6.0

AI-powered commit message generator using tree-sitter semantic analysis and local LLMs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

// SPDX-FileCopyrightText: 2026 Sephyi <me@sephy.io>
//
// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial

use clap::Parser;

#[derive(Parser, Debug, Default)]
#[command(name = "commitbee")]
#[command(version)]
#[command(about = "AI-powered commit message generator", long_about = None)]
pub struct Cli {
    /// LLM provider (ollama, openai, anthropic)
    #[arg(short, long, env = "COMMITBEE_PROVIDER")]
    pub provider: Option<String>,

    /// Model name
    #[arg(short, long, env = "COMMITBEE_MODEL")]
    pub model: Option<String>,

    /// Auto-confirm and commit without prompting
    #[arg(short = 'y', long)]
    pub yes: bool,

    /// Print message only, don't commit
    #[arg(long)]
    pub dry_run: bool,

    /// Allow committing with detected secrets (local only)
    #[arg(long)]
    pub allow_secrets: bool,

    /// Generate N candidate messages (default 1, max 5)
    #[arg(short = 'n', long, default_value_t = 1, value_parser = clap::value_parser!(u8).range(1..=5))]
    pub generate: u8,

    /// Show the prompt sent to LLM
    #[arg(long)]
    pub show_prompt: bool,

    /// Disable commit split suggestions
    #[arg(long)]
    pub no_split: bool,

    /// Disable scope in commit messages
    #[arg(long)]
    pub no_scope: bool,

    /// Copy generated message to clipboard instead of committing
    #[arg(long)]
    pub clipboard: bool,

    /// Exclude files matching glob pattern (repeatable)
    #[arg(long = "exclude", value_name = "GLOB")]
    pub exclude: Vec<String>,

    /// Generate commit message in specified language (e.g., de, ja, fr)
    #[arg(long)]
    pub locale: Option<String>,

    /// Verbose output
    #[arg(short, long)]
    pub verbose: bool,

    #[command(subcommand)]
    pub command: Option<Commands>,
}

#[derive(clap::Subcommand, Debug)]
pub enum HookAction {
    /// Install prepare-commit-msg hook
    Install,
    /// Remove prepare-commit-msg hook
    Uninstall,
    /// Check if hook is installed
    Status,
}

#[derive(clap::Subcommand, Debug)]
pub enum Commands {
    /// Initialize config file
    Init,
    /// Show current configuration
    Config,
    /// Check configuration and provider connectivity
    Doctor,
    /// Generate shell completions
    Completions {
        /// Shell to generate completions for
        #[arg(value_enum)]
        shell: clap_complete::Shell,
    },
    /// Manage prepare-commit-msg git hook
    Hook {
        #[command(subcommand)]
        action: HookAction,
    },
    /// Store API key in system keychain
    #[cfg(feature = "secure-storage")]
    SetKey {
        /// Provider to store key for (openai, anthropic)
        provider: String,
    },
    /// Check if API key exists in system keychain
    #[cfg(feature = "secure-storage")]
    GetKey {
        /// Provider to check key for (openai, anthropic)
        provider: String,
    },
    /// Run evaluation against fixture diffs (dev only)
    #[cfg(feature = "eval")]
    Eval {
        /// Directory containing evaluation fixtures
        #[arg(long, default_value = "tests/fixtures/eval")]
        fixtures_dir: std::path::PathBuf,

        /// Only run fixtures matching this pattern
        #[arg(long)]
        filter: Option<String>,
    },
}