CLI reference
Git Vibe keeps the command surface compact, but each command has a specific role.
If you need the built-in summary, run:
git vibe helpStart work
git vibe code <name>
Open or create a vibe for a task name.
git vibe code fix-login-redirectOptions:
--editor: always open the workspace app after opening the vibe--no-editor: never open the workspace app--codex: prefer Codex Desktop for workspace opening--vscode: prefer VS Code for workspace opening--agent <agent>: attach session metadata such ascodex--task <task>: attach a short task description
git vibe issue <number>
Open or create a vibe from a GitHub issue number.
git vibe issue 42Options:
- same flags as
git vibe code
git vibe start <name>
Alias for opening a vibe without launching the editor.
git vibe start fix-login-redirectSession and context
git vibe session [name]
Show or update session metadata for a vibe.
git vibe session 42
git vibe session --agent codex --task "polish the docs" 42Options:
--agent <agent>: set or replace the agent label--task <task>: set or replace the task description--clear: remove stored session metadata
git vibe enter [name]
Re-enter a vibe and print its context.
git vibe enter 42git vibe open [name]
Open an existing vibe in Codex Desktop or VS Code.
git vibe open 42
git vibe open --codex 42
git vibe open --vscode 42Options:
--codex: force Codex Desktop--vscode: force VS Code
git vibe diff [name]
Show the vibe diff against its merge base, plus untracked files.
git vibe diff 42git vibe status [name]
git vibe check [name]
Show branch, path, compare target, PR state, check summary, session context, and repository settings.
git vibe check
git vibe status 42check is an alias for status.
git vibe checks [name]
Show detailed PR checks for a vibe.
git vibe checks 42git vibe path <name>
Print the filesystem path for a vibe worktree.
git vibe path 42PR flow
git vibe pr [name]
git vibe submit [name]
Create a pull request for the vibe branch.
git vibe pr
git vibe submit 42Options:
--draft: create a draft PR--web: open GitHub's PR creation flow in the browser--title <title>: set the PR title explicitly--body <body>: set the PR body explicitly
submit is an alias for pr.
Finish and cleanup
git vibe finish [name]
Finish a vibe after it has merged.
git vibe finish --sync 42Options:
--sync: fetch before checking merge state--local: fast-forward merge the vibe into the base branch locally before cleanup--delete-remote: delete the remote vibe branch after merge verification--keep-remote: keep the remote vibe branch even if repository config says to delete it
git vibe list
Show all active vibes with branch, state, ahead/behind, session summary, changes, and path.
git vibe listgit vibe doctor
Check for missing or stale worktrees.
git vibe doctor
git vibe doctor --repairOptions:
--repair: run worktree repair and prune stale metadata
git vibe prune
Prune stale worktree metadata.
git vibe pruneRelease flow
git vibe release <version>
git vibe ship <version>
Create the release commit and tag from main.
git vibe release 0.0.4
git vibe ship 0.0.4 --pushOptions:
--push: pushmainand the new tag after the release is created
ship is an alias for release.
Utilities
git vibe version
Print the installed Git Vibe version.
git vibe versiongit vibe hook <pre-commit|commit-msg|pre-push> [args...]
Internal hook entrypoint used by the installed Git hooks.
Most users do not run this directly.
A few common commands
git vibe issue 42
git vibe check
git vibe diff
git vibe pr
git vibe finish --sync 42
git vibe release 0.0.4 --push