git-copilot-commit 0.6.0__py3-none-any.whl → 0.6.1__py3-none-any.whl

git_copilot_commit/cli.py

@@ -9,12 +9,10 @@ import re
 import sys
 from typing import Annotated, Sequence
 
-import rich
-import typer
+import cyclopts
 from rich.console import Console
 from rich.panel import Panel
-from rich.prompt import Confirm
-from typer.main import get_command
+from rich.prompt import Confirm, Prompt
 
 from .git import GitRepository, GitError, GitStatus, NotAGitRepositoryError
 from .split_commits import (
@@ -34,7 +32,7 @@ from .llms import core as llm
 from .llms import providers
 
 console = Console()
-app = typer.Typer(help=__doc__, add_completion=False)
+app = cyclopts.App(help=__doc__, version=lambda: f"git-copilot-commit {__version__}")
 
 COMMIT_MESSAGE_PROMPT_FILENAME = "commit-message-generator-prompt.md"
 SPLIT_COMMIT_PLANNER_PROMPT_FILENAME = "split-commit-planner-prompt.md"
@@ -57,28 +55,31 @@ NATIVE_TLS_HELP = (
 
 CaBundleOption = Annotated[
     str | None,
-    typer.Option("--ca-bundle", metavar="PATH", help=CA_BUNDLE_HELP),
+    cyclopts.Parameter(name="--ca-bundle", help=CA_BUNDLE_HELP),
 ]
 InsecureOption = Annotated[
     bool,
-    typer.Option("--insecure", help="Disable SSL certificate verification."),
+    cyclopts.Parameter(name="--insecure", help="Disable SSL certificate verification."),
 ]
 NativeTlsOption = Annotated[
     bool,
-    typer.Option("--native-tls/--no-native-tls", help=NATIVE_TLS_HELP),
+    cyclopts.Parameter(
+        name="--native-tls",
+        negative="--no-native-tls",
+        help=NATIVE_TLS_HELP,
+    ),
 ]
 ProviderOption = Annotated[
     str | None,
-    typer.Option(
-        "--provider",
+    cyclopts.Parameter(
+        name="--provider",
         help="LLM provider to use: copilot or openai.",
     ),
 ]
 BaseUrlOption = Annotated[
     str | None,
-    typer.Option(
-        "--base-url",
-        metavar="URL",
+    cyclopts.Parameter(
+        name="--base-url",
         help=(
             "Base URL for an OpenAI-compatible provider, for example "
             "http://127.0.0.1:11434/v1."
@@ -87,8 +88,8 @@ BaseUrlOption = Annotated[
 ]
 ApiKeyOption = Annotated[
     str | None,
-    typer.Option(
-        "--api-key",
+    cyclopts.Parameter(
+        name="--api-key",
         help="API key for an OpenAI-compatible provider. Omit when the server does not require one.",
     ),
 ]
@@ -96,8 +97,8 @@ ApiKeyOption = Annotated[
 
 SplitOption = Annotated[
     bool,
-    typer.Option(
-        "--split",
+    cyclopts.Parameter(
+        name="--split",
         help=(
             "Split staged hunks into multiple commits automatically. Pass "
             "`--split=N` to express a preference for N commits."
@@ -106,10 +107,10 @@ SplitOption = Annotated[
 ]
 SplitCountOption = Annotated[
     int | None,
-    typer.Option(
-        "--split-count",
-        hidden=True,
-        min=1,
+    cyclopts.Parameter(
+        name="--split-count",
+        show=False,
+        validator=cyclopts.validators.Number(gte=1),
     ),
 ]
 
@@ -225,39 +226,13 @@ def order_prepared_split_commits(
 def run(args: Sequence[str] | None = None) -> None:
     """Run the CLI entrypoint with argument normalization."""
     raw_args = list(args) if args is not None else sys.argv[1:]
-    command = get_command(app)
-    command.main(
-        args=preprocess_cli_args(raw_args),
-        prog_name=Path(sys.argv[0]).name,
-    )
-
-
-def version_callback(value: bool):
-    if value:
-        rich.print(f"git-copilot-commit [bold yellow]{__version__}[/]")
-        raise typer.Exit()
+    app(preprocess_cli_args(raw_args))
 
 
-@app.callback(invoke_without_command=True)
-def main(
-    ctx: typer.Context,
-    _: bool = typer.Option(
-        False, "--version", callback=version_callback, help="Show version and exit"
-    ),
-):
-    """
-    Automatically commit changes in the current git repository.
-    """
-    if ctx.invoked_subcommand is None:
-        # Show help when no command is provided
-        console.print(ctx.get_help())
-        raise typer.Exit()
-    else:
-        # Don't show version for print command to avoid interfering with pipes
-        if ctx.invoked_subcommand != "echo":
-            console.print(
-                f"[bold]{(__package__ or 'git_copilot_commit').replace('_', '-')}[/] - [bold green]v{__version__}[/]\n"
-            )
+def print_cli_banner() -> None:
+    """Render the CLI banner before command output."""
+    package_name = (__package__ or "git_copilot_commit").replace("_", "-")
+    console.print(f"[bold]{package_name}[/] - [bold green]v{__version__}[/]\n")
 
 
 def get_prompt_locations(filename: str):
@@ -280,7 +255,7 @@ def resolve_prompt_file() -> Path | None:
         console.print(
             f"[red]Configured default prompt file in {settings.config_file} is invalid.[/red]"
         )
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
     if configured_prompt_file is None:
         return None
@@ -298,7 +273,7 @@ def load_system_prompt() -> str:
             console.print(
                 f"[red]Error reading prompt file {resolved_prompt_file}: {exc}[/red]"
             )
-            raise typer.Exit(1)
+            raise SystemExit(1)
 
     return load_named_prompt(COMMIT_MESSAGE_PROMPT_FILENAME)
 
@@ -312,7 +287,7 @@ def load_named_prompt(filename: str) -> str:
             continue
 
     console.print(f"[red]Error: Prompt file {filename} not found in any location[/red]")
-    raise typer.Exit(1)
+    raise SystemExit(1)
 
 
 def build_http_client_config(
@@ -357,7 +332,7 @@ def build_commit_message_prompt(
     """Build the prompt used to generate a commit message."""
     if not status.has_staged_changes:
         console.print("[red]No staged changes to commit.[/red]")
-        raise typer.Exit()
+        raise SystemExit()
 
     prompt_parts = [
         "`git status`:\n",
@@ -383,7 +358,6 @@ def normalize_model_name(model: str | None) -> str | None:
     if model is not None:
         for prefix in (
             "copilot/",
-            "openai/",
             "openai-compatible/",
         ):
             if model.startswith(prefix):
@@ -506,13 +480,13 @@ def commit_with_retry_no_verify(
             "Retry commit with [bold]`-n`[/] (skip hooks) using the same commit message?",
             default=True,
         ):
-            raise typer.Exit(1)
+            raise SystemExit(1)
 
     try:
         return repo.commit(message, use_editor=use_editor, no_verify=True, env=env)
     except GitError as retry_error:
         console.print(f"[red]Commit with -n failed: {retry_error}[/red]")
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
 
 def ensure_copilot_authentication(
@@ -534,7 +508,7 @@ def ensure_copilot_authentication(
         )
     except copilot.LLMError as exc:
         print_llm_error("Authentication failed", exc)
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
 
 def stage_changes_for_commit(
@@ -590,7 +564,7 @@ def request_commit_message(
             )
     except llm.LLMError as exc:
         print_llm_error("Could not generate a commit message", exc)
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
 
 def request_split_commit_plan(
@@ -626,7 +600,7 @@ def request_split_commit_plan(
     except llm.LLMError as exc:
         if not should_retry_with_compact_prompt(exc):
             print_llm_error("Could not generate a split commit plan", exc)
-            raise typer.Exit(1)
+            raise SystemExit(1)
 
         console.print(
             "[yellow]Staged patch units exceeded the model context window; retrying split planning with summaries only.[/yellow]"
@@ -658,7 +632,7 @@ def request_split_commit_plan(
             )
     except llm.LLMError as exc:
         print_llm_error("Could not generate a split commit plan", exc)
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
     return parse_split_plan_response(
         response,
@@ -700,7 +674,7 @@ def request_split_commit_messages(
         return prepared_commits
     except llm.LLMError as exc:
         print_llm_error("Could not generate split commit messages", exc)
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
 
 def confirm_split_commit_count(
@@ -730,7 +704,7 @@ def confirm_split_commit_count(
         return plan
 
     console.print("Split commit plan cancelled.")
-    raise typer.Exit()
+    raise SystemExit()
 
 
 def display_commit_message(commit_message: str) -> None:
@@ -769,7 +743,7 @@ def execute_commit_action(
     if yes:
         return commit_with_retry_no_verify(repo, commit_message)
 
-    choice = typer.prompt(
+    choice = Prompt.ask(
         "Choose action: (c)ommit, (e)dit message, (q)uit",
         default="c",
         show_default=True,
@@ -777,7 +751,7 @@ def execute_commit_action(
 
     if choice == "q":
         console.print("Commit cancelled.")
-        raise typer.Exit()
+        raise SystemExit()
     if choice == "e":
         console.print("[cyan]Opening git editor...[/cyan]")
         return commit_with_retry_no_verify(repo, commit_message, use_editor=True)
@@ -785,7 +759,7 @@ def execute_commit_action(
         return commit_with_retry_no_verify(repo, commit_message)
 
     console.print("Invalid choice. Commit cancelled.")
-    raise typer.Exit()
+    raise SystemExit()
 
 
 def execute_split_commit_plan(
@@ -797,7 +771,7 @@ def execute_split_commit_plan(
     """Run the split-commit plan against temporary alternate indexes."""
     use_editor = False
     if not yes:
-        choice = typer.prompt(
+        choice = Prompt.ask(
             "Choose action: (c)ommit all, (e)dit each message, (q)uit",
             default="c",
             show_default=True,
@@ -805,12 +779,12 @@ def execute_split_commit_plan(
 
         if choice == "q":
             console.print("Commit cancelled.")
-            raise typer.Exit()
+            raise SystemExit()
         if choice == "e":
             use_editor = True
         elif choice != "c":
             console.print("Invalid choice. Commit cancelled.")
-            raise typer.Exit()
+            raise SystemExit()
 
     execution_state = SplitCommitExecutionState(
         original_head_sha=repo.get_head_sha() if repo.has_commit("HEAD") else None,
@@ -840,16 +814,19 @@ def execute_split_commit_plan(
                     console.print(
                         f"[red]Failed to apply the planned changes for commit {index}: {exc}[/red]"
                     )
-                    raise typer.Exit(1)
-
-                commit_shas.append(
-                    commit_with_retry_no_verify(
-                        repo,
-                        prepared_commit.message,
-                        use_editor=use_editor,
-                        env=alternate_index.env,
+                    raise SystemExit(1)
+
+                try:
+                    commit_shas.append(
+                        repo.create_commit_from_index(
+                            prepared_commit.message,
+                            index=alternate_index,
+                            use_editor=use_editor,
+                        )
                     )
-                )
+                except GitError as exc:
+                    console.print(f"[red]Failed to create commit {index}: {exc}[/red]")
+                    raise SystemExit(1)
     except BaseException:
         try:
             if execution_state.original_head_sha is not None:
@@ -1012,22 +989,29 @@ def handle_split_commit_flow(
         console.print(f"[green]{commit_sha[:8]}[/green] {prepared_commit.message}")
 
 
-@app.command("authenticate")
-@app.command("login", hidden=True)
+@app.command(name="authenticate")
+@app.command(name="login", show=False)
 def authenticate(
-    enterprise_domain: str | None = typer.Option(
-        None,
-        "--enterprise-domain",
-        help="GitHub Enterprise hostname. Omit for github.com.",
-    ),
-    force: bool = typer.Option(
-        False, "--force", help="Replace cached GitHub Copilot credentials"
-    ),
+    enterprise_domain: Annotated[
+        str | None,
+        cyclopts.Parameter(
+            name="--enterprise-domain",
+            help="GitHub Enterprise hostname. Omit for github.com.",
+        ),
+    ] = None,
+    force: Annotated[
+        bool,
+        cyclopts.Parameter(
+            name="--force",
+            help="Replace cached GitHub Copilot credentials",
+        ),
+    ] = False,
     ca_bundle: CaBundleOption = None,
     insecure: InsecureOption = False,
     native_tls: NativeTlsOption = False,
 ):
     """Authenticate with GitHub Copilot and cache credentials locally."""
+    print_cli_banner()
     http_client_config = build_http_client_config(
         ca_bundle=ca_bundle,
         insecure=insecure,
@@ -1041,10 +1025,10 @@ def authenticate(
         )
     except copilot.LLMError as exc:
         print_llm_error("Authentication failed", exc)
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
 
-@app.command("summary")
+@app.command(name="summary")
 def summary(
     provider: ProviderOption = None,
     base_url: BaseUrlOption = None,
@@ -1054,6 +1038,7 @@ def summary(
     native_tls: NativeTlsOption = False,
 ):
     """Show the configured LLM provider summary."""
+    print_cli_banner()
     http_client_config = build_http_client_config(
         ca_bundle=ca_bundle,
         insecure=insecure,
@@ -1071,24 +1056,27 @@ def summary(
         )
     except llm.LLMError as exc:
         print_llm_error("Could not load provider summary", exc)
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
 
-@app.command("models")
+@app.command(name="models")
 def models_command(
     provider: ProviderOption = None,
     base_url: BaseUrlOption = None,
     api_key: ApiKeyOption = None,
-    vendor: str | None = typer.Option(
-        None,
-        "--vendor",
-        help="Filter listed models by vendor: anthropic, gemini/google, or openai.",
-    ),
+    vendor: Annotated[
+        str | None,
+        cyclopts.Parameter(
+            name="--vendor",
+            help="Filter listed models by vendor: anthropic, gemini/google, or openai.",
+        ),
+    ] = None,
     ca_bundle: CaBundleOption = None,
     insecure: InsecureOption = False,
     native_tls: NativeTlsOption = False,
 ):
     """List available models for the configured LLM provider."""
+    print_cli_banner()
     http_client_config = build_http_client_config(
         ca_bundle=ca_bundle,
         insecure=insecure,
@@ -1116,32 +1104,41 @@ def models_command(
         )
     except llm.LLMError as exc:
         print_llm_error("Could not load models", exc)
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
 
-@app.command()
+@app.command
 def commit(
-    all_files: bool = typer.Option(
-        False, "--all", "-a", help="Stage all files before committing"
-    ),
+    all_files: Annotated[
+        bool,
+        cyclopts.Parameter(
+            name=("--all", "-a"),
+            help="Stage all files before committing",
+        ),
+    ] = False,
     split: SplitOption = False,
     split_count: SplitCountOption = None,
-    model: str | None = typer.Option(
-        None,
-        "--model",
-        "-m",
-        metavar="MODEL_ID",
-        help="Model to use for generating commit message",
-    ),
-    yes: bool = typer.Option(
-        False, "--yes", "-y", help="Automatically accept the generated commit message"
-    ),
-    context: str = typer.Option(
-        "",
-        "--context",
-        "-c",
-        help="Optional user-provided context to guide commit message",
-    ),
+    model: Annotated[
+        str | None,
+        cyclopts.Parameter(
+            name=("--model", "-m"),
+            help="Model to use for generating commit message",
+        ),
+    ] = None,
+    yes: Annotated[
+        bool,
+        cyclopts.Parameter(
+            name=("--yes", "-y"),
+            help="Automatically accept the generated commit message",
+        ),
+    ] = False,
+    context: Annotated[
+        str,
+        cyclopts.Parameter(
+            name=("--context", "-c"),
+            help="Optional user-provided context to guide commit message",
+        ),
+    ] = "",
     provider: ProviderOption = None,
     base_url: BaseUrlOption = None,
     api_key: ApiKeyOption = None,
@@ -1152,11 +1149,12 @@ def commit(
     """
     Generate commit message based on changes in the current git repository and commit them.
     """
+    print_cli_banner()
     try:
         repo = GitRepository()
     except NotAGitRepositoryError:
         console.print("[red]Error: Not in a git repository[/red]")
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
     http_client_config = build_http_client_config(
         ca_bundle=ca_bundle,
@@ -1171,7 +1169,7 @@ def commit(
         )
     except llm.LLMError as exc:
         print_llm_error("Could not resolve the LLM provider", exc)
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
     if provider_config.provider == "copilot":
         ensure_copilot_authentication(http_client_config)
@@ -1181,7 +1179,7 @@ def commit(
 
     if not status.files:
         console.print("[yellow]No changes to commit.[/yellow]")
-        raise typer.Exit()
+        raise SystemExit()
 
     status = stage_changes_for_commit(repo, status, all_files=all_files)
 
@@ -1199,7 +1197,7 @@ def commit(
         )
     except llm.LLMError as exc:
         print_llm_error("Could not select a model", exc)
-        raise typer.Exit(1)
+        raise SystemExit(1)
 
     display_selected_model(selected_model)
     model = selected_model.id

git_copilot_commit/git.py

@@ -1,4 +1,5 @@
 import os
+import shlex
 import subprocess
 import tempfile
 from contextlib import contextmanager
@@ -352,6 +353,15 @@ class GitRepository:
             )
         raise GitCommandError(f"Git command failed: git update-ref -d {ref}")
 
+    def update_ref(
+        self, ref: str, new_value: str, *, old_value: str | None = None
+    ) -> None:
+        """Update a ref to point at a new object id."""
+        args = ["update-ref", ref, new_value]
+        if old_value is not None:
+            args.append(old_value)
+        self._run_git_command(args)
+
     def create_alternate_index(self, from_ref: str = "HEAD") -> AlternateGitIndex:
         """Create a temporary git index initialized from the provided ref."""
         fd, index_path = tempfile.mkstemp(prefix="git-copilot-commit-", suffix=".index")
@@ -382,6 +392,15 @@ class GitRepository:
         """Initialize an alternate index with an empty tree."""
         self._run_git_command(["read-tree", "--empty"], env=index.env)
 
+    def write_tree(self, *, env: Mapping[str, str] | None = None) -> str:
+        """Write the current index as a tree object and return its SHA."""
+        result = self._run_git_command(["write-tree"], env=env)
+        tree_sha = result.stdout.strip()
+        if tree_sha:
+            return tree_sha
+
+        raise GitCommandError("Git command failed: git write-tree")
+
     def apply_patch(
         self,
         patch: str,
@@ -422,6 +441,110 @@ class GitRepository:
         """Validate whether a cached patch can be applied to an alternate index."""
         self.check_patch(patch, cached=True, env=index.env)
 
+    def edit_commit_message(
+        self,
+        message: str,
+        *,
+        env: Mapping[str, str] | None = None,
+    ) -> str:
+        """Open git's configured editor with a starting message."""
+        with tempfile.NamedTemporaryFile(
+            mode="w",
+            suffix=".txt",
+            delete=False,
+            encoding="utf-8",
+        ) as f:
+            f.write(message)
+            temp_path = Path(f.name)
+
+        try:
+            editor = self._run_git_command(
+                ["var", "GIT_EDITOR"], env=env
+            ).stdout.strip()
+            if not editor:
+                raise GitCommandError("Git command failed: git var GIT_EDITOR")
+
+            editor_command = f"{editor} {shlex.quote(str(temp_path))}"
+            try:
+                # Git editor configuration is shell syntax, so execute it the same way.
+                subprocess.run(
+                    editor_command,
+                    cwd=self.repo_path,
+                    timeout=self.timeout,
+                    check=True,
+                    env=self._build_env(env),
+                    shell=True,
+                )
+            except subprocess.CalledProcessError:
+                raise GitCommandError(f"Git editor failed: {editor_command}")
+            except subprocess.TimeoutExpired:
+                raise GitCommandError(f"Git editor timed out: {editor_command}")
+
+            edited_message = temp_path.read_text(encoding="utf-8").strip()
+            if edited_message:
+                return edited_message
+
+            raise GitCommandError("Commit message cannot be empty")
+        finally:
+            temp_path.unlink(missing_ok=True)
+
+    def create_commit_object(
+        self,
+        tree_sha: str,
+        *,
+        message: str | None = None,
+        message_file: Path | None = None,
+        parent_refs: tuple[str, ...] = (),
+        env: Mapping[str, str] | None = None,
+    ) -> str:
+        """Create a commit object without updating refs."""
+        if (message is None) == (message_file is None):
+            raise ValueError("Exactly one of message or message_file is required")
+
+        args = ["commit-tree", tree_sha]
+        for parent_ref in parent_refs:
+            args.extend(["-p", parent_ref])
+
+        if message_file is not None:
+            args.extend(["-F", str(message_file)])
+            result = self._run_git_command(args, env=env)
+        else:
+            result = self._run_git_command(args, env=env, input_text=message)
+
+        commit_sha = result.stdout.strip()
+        if commit_sha:
+            return commit_sha
+
+        raise GitCommandError(f"Git command failed: git {' '.join(args)}")
+
+    def advance_head_to_commit(self, commit_sha: str) -> None:
+        """Move HEAD or the current branch to a commit without touching the real index."""
+        ref = self.get_symbolic_head_ref() or "HEAD"
+        self.update_ref(ref, commit_sha)
+
+    def create_commit_from_index(
+        self,
+        message: str,
+        *,
+        index: AlternateGitIndex,
+        use_editor: bool = False,
+    ) -> str:
+        """Create a commit from an alternate index using plumbing commands only."""
+        commit_message = message
+        if use_editor:
+            commit_message = self.edit_commit_message(message, env=index.env)
+
+        parent_refs = ("HEAD",) if self.has_commit("HEAD") else ()
+        tree_sha = self.write_tree(env=index.env)
+        commit_sha = self.create_commit_object(
+            tree_sha,
+            message=commit_message,
+            parent_refs=parent_refs,
+            env=index.env,
+        )
+        self.advance_head_to_commit(commit_sha)
+        return commit_sha
+
     def commit(
         self,
         message: str | None = None,

{git_copilot_commit-0.6.0.dist-info → git_copilot_commit-0.6.1.dist-info}/METADATA

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: git-copilot-commit
-Version: 0.6.0
+Version: 0.6.1
 Summary: Automatically generate and commit changes using GitHub Copilot or OpenAI-compatible LLMs
 Author-email: Dheepak Krishnamurthy <1813121+kdheepak@users.noreply.github.com>
 License-File: LICENSE
 Requires-Python: >=3.12
+Requires-Dist: cyclopts>=4.11.0
 Requires-Dist: httpx>=0.28.0
 Requires-Dist: platformdirs>=4.0.0
 Requires-Dist: rich>=14.0.0
 Requires-Dist: truststore>=0.10.4
-Requires-Dist: typer>=0.16.0
 Description-Content-Type: text/markdown
 
 # `git-copilot-commit`
@@ -96,7 +96,11 @@ git-copilot-commit --help
 
 ### OpenAI-compatible provider
 
-1. Point the CLI at your server:
+1. Point the CLI at your server.
+
+   The base URL can be either the provider root such as `http://127.0.0.1:11434/v1`
+   or the full chat completions endpoint such as
+   `http://127.0.0.1:11434/v1/chat/completions`.
 
    ```bash
    uvx git-copilot-commit models \
@@ -104,7 +108,7 @@ git-copilot-commit --help
      --base-url http://127.0.0.1:11434/v1
    ```
 
-2. Generate and commit:
+2. Generate and commit.
 
    ```bash
    uvx git-copilot-commit commit \
@@ -115,6 +119,17 @@ git-copilot-commit --help
 
    If your server requires an API key, also pass `--api-key ...` or set `OPENAI_API_KEY`.
 
+3. Example: use a self-hosted GPT-OSS model:
+
+   ```bash
+   uvx git-copilot-commit commit \
+     --provider openai \
+     --base-url http://example.com:8001/v1/chat/completions \
+     --model openai/gpt-oss-120b
+   ```
+
+   Model ids with slashes such as `openai/gpt-oss-120b` are supported.
+
 ## Usage
 
 ### Commit changes
@@ -175,6 +190,15 @@ uvx git-copilot-commit commit \
   --model your-model-id
 ```
 
+Use a self-hosted GPT-OSS endpoint:
+
+```bash
+uvx git-copilot-commit commit \
+  --provider openai \
+  --base-url http://example.com:8001/v1/chat/completions \
+  --model openai/gpt-oss-120b
+```
+
 Split staged hunks into separate commits:
 
 ```bash
@@ -232,11 +256,21 @@ git ai-commit --all --yes --model claude-3.5-sonnet
 You can also set provider defaults with environment variables:
 
 ```bash
-export OPENAI_BASE_URL=http://127.0.0.1:11434/v1
+export GIT_COPILOT_COMMIT_PROVIDER=openai
+export GIT_COPILOT_COMMIT_BASE_URL=http://127.0.0.1:11434/v1
+export GIT_COPILOT_COMMIT_API_KEY=...
 export OPENAI_API_KEY=...
 git ai-commit --provider openai --model your-model-id
 ```
 
+For example:
+
+```bash
+export GIT_COPILOT_COMMIT_PROVIDER=openai
+export GIT_COPILOT_COMMIT_BASE_URL=http://example.com:8001/v1
+git ai-commit --model openai/gpt-oss-120b
+```
+
 > [!TIP]
 >
 > Show more context in diffs by running the following command:

{git_copilot_commit-0.6.0.dist-info → git_copilot_commit-0.6.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
 git_copilot_commit/__init__.py,sha256=v3x5oBkxwKJEZLv62QqSmP3iqNKLtZgrWZfH8eFzlQg,60
-git_copilot_commit/cli.py,sha256=MtxamoK9t7R_q79cs-dz7txHZ9vEqn9MCTlW1ieL_TU,37995
-git_copilot_commit/git.py,sha256=dEsyazWfD2TIVCpDObwu6TDWRBkzxEjdIKHrQ59h7I0,16697
+git_copilot_commit/cli.py,sha256=x5p_f71DhnYEED8-9rvJKqkjTbcwfXlN3zIvfxmYQfU,38011
+git_copilot_commit/git.py,sha256=EbXiicWygSlMM-F6rY4LCkchwCvsFTziJcdUZM-1vnw,21059
 git_copilot_commit/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 git_copilot_commit/settings.py,sha256=WrM10_J3F7QBfOVmPDWpNZrNHhmZSeN-9FqQZxgdWvQ,3730
 git_copilot_commit/split_commits.py,sha256=rHyuVJggjmYjbva7BVqsM3aZRxUgOKkuZtxxvFRcu6Q,15060
@@ -12,8 +12,8 @@ git_copilot_commit/llms/openai_api.py,sha256=wkadrdSDadbLRaLWEpOhsYYjrbtEYg14CFb
 git_copilot_commit/llms/providers.py,sha256=rA2mdCQR8pfVDhwV5mqpdHlT1nxkWtowQ1Smt0zXCa0,11565
 git_copilot_commit/prompts/commit-message-generator-prompt.md,sha256=3Dz8GCdumFNAtXOdTlpRtgBnmX0WyrPL6tdfMgNyYiE,2411
 git_copilot_commit/prompts/split-commit-planner-prompt.md,sha256=tDI0v1udOhkRQM31M892FMzcPMYHExnU0fjTGia1V2k,1510
-git_copilot_commit-0.6.0.dist-info/METADATA,sha256=C1cRXfdsxv-ulzjWnlLvhdHJbYGOkwjKPT9nxXNUWtI,8050
-git_copilot_commit-0.6.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-git_copilot_commit-0.6.0.dist-info/entry_points.txt,sha256=-D4bQqiuSPwQJG2zx--vJbZD1iqB5coUfoJ_gmC3rSg,66
-git_copilot_commit-0.6.0.dist-info/licenses/LICENSE,sha256=14lNZAoKJPI1U7eGpletjN_PFm1JwP1vT_0jFKY6eWg,1065
-git_copilot_commit-0.6.0.dist-info/RECORD,,
+git_copilot_commit-0.6.1.dist-info/METADATA,sha256=3pBOX2m_9i-UKx-dQUu5fwr2gA638RePMzEBe8rf4E4,8986
+git_copilot_commit-0.6.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+git_copilot_commit-0.6.1.dist-info/entry_points.txt,sha256=-D4bQqiuSPwQJG2zx--vJbZD1iqB5coUfoJ_gmC3rSg,66
+git_copilot_commit-0.6.1.dist-info/licenses/LICENSE,sha256=14lNZAoKJPI1U7eGpletjN_PFm1JwP1vT_0jFKY6eWg,1065
+git_copilot_commit-0.6.1.dist-info/RECORD,,