Driffly

Driffly is a lightweight VS Code extension that generates a Conventional Commit message and writes it into the commit input. If changes are staged, it uses only the staged diff; otherwise, it uses local changes, including new files. It uses your authenticated Codex CLI, requires no API key, and never runs git commit.

Install

Install Driffly from the Visual Studio Marketplace to receive automatic updates.

Requirements

VS Code 1.95 or later with the built-in Git extension enabled.
Git installed.
Codex CLI available in the Extension Host PATH and authenticated with codex login. Check with codex login status.
A CLI version that supports exec --ignore-user-config --ephemeral --output-last-message and the shell_tool feature. The invocation is verified with codex-cli 0.154.0-alpha.6.2; older versions may need an update.
Access to the gpt-5.6-luna model in your account, or another available model selected in the extension settings.

Optionally, set driffly.codexPath to the absolute path of a trusted CLI installation to avoid relying on PATH order. On macOS, Driffly also checks common Homebrew locations, ~/.bun/bin, and executables bundled with Codex.app and ChatGPT.app. On Windows, use a native codex.exe; .cmd wrappers are not run through a shell. In SSH, WSL, or containers, Git and Codex must be installed and authenticated in that remote environment.

Use

Open a Git repository with local changes in VS Code.
Staging changes is optional. When staging is not empty, Driffly considers only the staged diff.
Open Source Control and select ✨ Generate Commit Message in the repository header. The command is also available as Driffly: Generate Commit Message in the Command Palette.
Review and edit the generated message, then commit when you are ready.

Driffly only fills the commit input. It never stages files and never runs git commit.

Settings

Select the gear next to ✨ in Source Control, or run Driffly: Open Settings from the Command Palette.

Setting	Default	Purpose
`driffly.language`	`english`	Generate the subject in English or Spanish; the Conventional Commit type remains in English
`driffly.model`	`gpt-5.6-luna`	Model used by the CLI
`driffly.codexPath`	empty	Absolute path to a trusted Codex executable; empty keeps automatic detection
`driffly.reasoningEffort`	`low`	Reasoning effort; availability depends on the selected model
`driffly.fastMode`	`false`	Enable Fast on compatible models; increases speed and credit usage
`driffly.maxLength`	`72`	Target length from 20 to 200 characters, without cutting words
`driffly.useScope`	`auto`	Add a scope automatically, always, or never
`driffly.lowercase`	`true`	Request lowercase where natural while preserving names and identifiers
`driffly.usageLogging`	`repositoryName`	Local history: disabled, repository name, or full path

Length and lowercase are model instructions, not destructive transformations. The scope is validated when the message is received.

Behavior and privacy

Driffly activates only when you run its command. It has no persistent processes, polling, webviews, or runtime npm dependencies. It uses the VS Code Git API to select the repository and access the commit input.

When staged changes exist, only that diff is sent through stdin to the local Codex CLI. When staging is empty, Driffly sends tracked changes and new files that Git does not ignore. The CLI processes this content through the model service using your existing authentication. Generation is not offline and is subject to your account's limits and terms.

The CLI runs from a temporary directory in a read-only sandbox without loading personal configuration; authentication is preserved, while shell access and web search are disabled. This prevents project instructions and MCP servers from being used for this task. Driffly does not write changes, generated messages, raw stderr, tokens, or environment variables to the Driffly output channel. The temporary response file is deleted after use, and --ephemeral prevents the CLI session from being persisted.

By default, Driffly stores a local JSONL usage history with one row per attempt. It records the timestamp, outcome, duration, change source, size, model, language, and repository name only. It never stores the diff or generated message. Set driffly.usageLogging to disable logging or include the full repository path. Use Driffly: Open Usage Log to view it and Driffly: Clear Usage Log to delete it after confirmation. The log rotates at 5 MiB and keeps two backups.

Diffs larger than 1 MiB are rejected, and binary content is not sent. Generation supports cancellation and a 120-second timeout; Git operations have a 15-second timeout. If relevant files change or you edit the commit input while generation is running, the result does not overwrite your text.

Troubleshooting

Run codex login status if authentication fails.
Update Codex CLI if it does not support the required arguments.
Select a model available to your account in Driffly: Open Settings.
In remote environments, install and authenticate Codex in the remote environment, not only on your local machine.
If automatic CLI detection fails, set driffly.codexPath to the absolute path of a trusted executable.

The Driffly output channel provides concise diagnostic information without recording the diff or generated commit message.

Driffly

nacholaciar

Driffly

Install

Requirements

Use

Settings

Behavior and privacy

Troubleshooting