rtk git

Overview

Proxy for git commands with token-optimized output. Supports all git flags and subcommands with specialized filtering for common operations.

Syntax

rtk git [GLOBAL_OPTIONS] <SUBCOMMAND> [ARGS...]

Global Options

All git global options are supported and passed through correctly:

string

Run as if git was started in <path> (can be repeated)

string

Override git config for this command

string

Set path to .git directory

string

Set path to working tree

Disable pager output

flag

Skip optional locks

flag

Treat repository as bare

Optimized Subcommands

rtk git status

Compact status with grouped changes.

rtk git status [FLAGS]

Output:

📌 main...origin/main
✅ Staged: 2 files
   src/main.rs
   src/lib.rs
📝 Modified: 1 files
   Cargo.toml
❓ Untracked: 3 files
   temp.txt
   debug.log
   ... +1 more

Token savings: 70%

rtk git log

One-line commit history with auto-truncation.

rtk git log [FLAGS]

Default flags applied:

--pretty=format:%h %s (%ar) <%an> (if not specified)
-10 (if no limit specified)
--no-merges (unless --merges requested)

Output:

abc1234 Add feature (2 days ago) <author>
def5678 Fix bug (1 week ago) <other>

Token savings: 60%

rtk git diff

Stat summary + compacted diff.

rtk git diff [FLAGS]

Output:

src/main.rs | 10 ++++------
1 file changed, 4 insertions(+), 6 deletions(-)

--- Changes ---
📄 src/main.rs
  @@ -42,3 +42,4 @@ fn main() {
  +    println!("new line");
  +5 -6

Flags:

--stat - Show only stat (no diff)
--no-compact - Disable RTK compacting

Token savings: 80%

rtk git show

Commit summary + stat + compacted diff.

rtk git show [COMMIT] [FLAGS]

Output:

abc1234 Add feature (2 days ago) <author>
src/main.rs | 5 +++--

📄 src/main.rs
  @@ -10,2 +10,3 @@
  +    new_code();

Special cases:

git show rev:path - Shows blob content (no diff formatting)
--stat - Shows only stat
--pretty=... - Custom format (no RTK filtering)

Token savings: 80%

rtk git add/commit/push/pull

Ultra-compact confirmations.

rtk git add [FILES...]
rtk git commit -m "message"
rtk git push [REMOTE] [BRANCH]
rtk git pull [REMOTE] [BRANCH]

Outputs:

ok ✓ 3 files changed, 10 insertions(+), 2 deletions(-)
ok ✓ abc1234
ok ✓ origin/main
ok ✓ 5 files +20 -10

Token savings: 59%

rtk git branch

Compact branch list with remote-only section.

rtk git branch [FLAGS]

Output:

* main
  develop
  feature/auth
  remote-only (2):
    release/v2
    hotfix/bug

Token savings: 65%

rtk git fetch/stash/worktree

rtk git fetch [REMOTE]
rtk git stash [list|show|pop|apply|drop|push]
rtk git worktree [list|add|remove]

All operations have compact output formats with essential info preserved.

Passthrough Support

Any git subcommand not listed above is passed through unchanged:

rtk git tag --list      # Full output
rtk git remote -v       # Full output
rtk git bisect start    # Full output

Savings: 0% (raw git output, but usage tracked)

Token Savings Summary

Command	Savings
`status`	70%
`log`	60%
`diff`	80%
`show`	80%
`add/commit/push/pull`	59%
`branch`	65%
`fetch/stash/worktree`	60-70%

rtk git status
# 📌 main...origin/main
# ✅ Staged: 2 files

rtk git log -5
# Last 5 commits in one-line format

rtk git diff --stat
# Only file stats, no diff

rtk git -C /path/to/repo status
# Run in different directory

rtk git tag -a v1.0 -m "Release"
# Full git behavior for unoptimized commands

Exit Codes

All git exit codes are preserved:

0 - Success
1 - Generic error
128+N - Fatal error

rtk gh - GitHub CLI operations
rtk diff - Universal diff command
rtk log - Log file filtering

Command Reference

Global Flags

Overview

Syntax

Global Options

Optimized Subcommands

rtk git status

rtk git log

rtk git diff

rtk git show

rtk git add/commit/push/pull

rtk git branch

rtk git fetch/stash/worktree

Passthrough Support

Token Savings Summary

Exit Codes

​Overview

​Syntax

​Global Options

​Optimized Subcommands

​rtk git status

​rtk git log

​rtk git diff

​rtk git show

​rtk git add/commit/push/pull

​rtk git branch

​rtk git fetch/stash/worktree

​Passthrough Support

​Token Savings Summary

​Exit Codes

​Related Commands

Overview

Syntax

Global Options

Optimized Subcommands

rtk git status

rtk git log

rtk git diff

rtk git show

rtk git add/commit/push/pull

rtk git branch

rtk git fetch/stash/worktree

Passthrough Support

Token Savings Summary

Exit Codes

Related Commands