mediagit status

Show files excluded by .mediagitignore in an “Ignored files:” section. Ignored files are always hidden from the “Untracked files:” list; this flag makes them visible.

Status Indicators

Short Format Codes

 M  modified in working tree
M   staged for commit
MM  staged with additional modifications
A   new file staged
AM  staged new file with modifications
D   deleted in working tree
?? untracked file
!! ignored file

Long Format Sections

Changes to be committed:
    (staged files ready for commit)

Changes not staged for commit:
    (modified files not yet staged)

Untracked files:
    (files not tracked by MediaGit)

Examples

Basic status

$ mediagit status
On branch main
Your branch is up to date with 'origin/main'.

Changes to be committed:
  (use "mediagit restore --staged <file>..." to unstage)
        new file:   project_video.mp4
        modified:   README.md

Changes not staged for commit:
  (use "mediagit add <file>..." to update what will be committed)
  (use "mediagit restore <file>..." to discard changes)
        modified:   config.json

Untracked files:
  (use "mediagit add <file>..." to include in commit)
        draft_design.psd
        temp_render.mov

Storage preview for staged files:
  Original size: 250.3 MB
  After compression: 42.1 MB (83.2% savings)
  Deduplication opportunities: 5 chunks (8.2 MB additional savings)

Short format

$ mediagit status --short
M  README.md
A  project_video.mp4
 M config.json
?? draft_design.psd
?? temp_render.mov

Short format with branch

$ mediagit status --short --branch
## main...origin/main [ahead 2]
M  README.md
A  project_video.mp4
 M config.json
?? draft_design.psd

Verbose status

$ mediagit status --verbose
On branch main
Your branch is ahead of 'origin/main' by 2 commits.
  (use "mediagit push" to publish your local commits)

Changes to be committed:
  (use "mediagit restore --staged <file>..." to unstage)
        new file:   project_video.mp4
          Size: 245.8 MB → 38.5 MB (compressed, 84.3% savings)
          Chunks: 63 (4 MB each)
          Deduplication: 3 chunks already exist (11.8 MB saved)

        modified:   README.md
          Size: 4.5 KB → 1.2 KB (delta encoded, 73.3% savings)
          Previous version: e4f3a2b
          Changes: +28 lines, -15 lines

Changes not staged for commit:
        modified:   config.json
          Size: 2.1 KB (not yet staged)
          Changes: +5 lines, -2 lines

Untracked files:
        draft_design.psd (89.2 MB)
        temp_render.mov (156.7 MB)

Object Database Status:
  Total objects: 2,847
  Total size: 1.2 GB → 185.3 MB (stored)
  Compression ratio: 84.5%
  Deduplication savings: 127.8 MB
  Cache hit rate: 92.3%

Storage Backend: AWS S3 (us-west-2)
  Status: Healthy ✓
  Bucket: mediagit-prod-assets
  Last sync: 2 minutes ago

Show ignored files

$ cat .mediagitignore
*.tmp
build/

$ mediagit status --ignored
Repository Status

Untracked files:
  (use "mediagit add <file>..." to include in what will be committed)

  new_asset.mp4

Ignored files:
  (add .mediagitignore negation '!<pattern>' to un-ignore)

  cache.tmp
  render.tmp

Porcelain output with ignored

$ mediagit status --porcelain --ignored
?? new_asset.mp4
!! cache.tmp
!! render.tmp

Machine-readable output

$ mediagit status --porcelain
M  README.md
A  project_video.mp4
 M config.json
?? draft_design.psd
?? temp_render.mov

After staging all changes

$ mediagit add --all
$ mediagit status
On branch main
Your branch is ahead of 'origin/main' by 1 commit.

Changes to be committed:
  (use "mediagit restore --staged <file>..." to unstage)
        new file:   draft_design.psd
        new file:   project_video.mp4
        new file:   temp_render.mov
        modified:   README.md
        modified:   config.json

Commit preview:
  5 files changed (3 added, 2 modified)
  Original size: 495.3 MB
  Compressed size: 78.6 MB (84.1% savings)
  Ready to commit ✓

Working Tree Status

Clean working tree

$ mediagit status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

Detached HEAD

$ mediagit status
HEAD detached at a3c8f9d
nothing to commit, working tree clean

Merge conflict

$ mediagit status
On branch feature-video
You have unmerged paths.
  (fix conflicts and run "mediagit commit")
  (use "mediagit merge --abort" to abort the merge)

Unmerged paths:
  (use "mediagit add <file>..." to mark resolution)
        both modified:   project_settings.json

Automatic merge strategy: Latest Modified Time
Conflicting files: 1
  - project_settings.json: local modified 2024-01-15, remote modified 2024-01-14
  - Resolution: Keep local version (newer)

Branch Tracking

Ahead of remote

$ mediagit status
On branch main
Your branch is ahead of 'origin/main' by 3 commits.
  (use "mediagit push" to publish your local commits)

Behind remote

$ mediagit status
On branch main
Your branch is behind 'origin/main' by 5 commits.
  (use "mediagit pull" to update your local branch)

Diverged branches

$ mediagit status
On branch main
Your branch and 'origin/main' have diverged,
and have 2 and 3 different commits each, respectively.
  (use "mediagit pull" to merge the remote branch)

Storage Insights

MediaGit status provides storage optimization insights:

$ mediagit status --verbose
...

Storage Optimization Opportunities:
  ✓ 3 files can benefit from delta encoding: 45.2 MB → 12.1 MB
  ✓ 2 files have duplicate chunks: 23.8 MB deduplication potential
  ✓ 1 file can use better compression: 18.3 MB → 5.2 MB

  Run "mediagit add --optimize" to apply optimizations

Performance

MediaGit status is optimized for large repositories:

Incremental checks: Only scan files with changed mtimes
Parallel scanning: Multi-threaded file status checking
Cache utilization: Reuse hash computations from previous operations
Smart sampling: For very large files, sample-based change detection

Typical performance:

Small repos (<1000 files): <100ms
Medium repos (<10000 files): <500ms
Large repos (>10000 files): <2s

Exit Status

0: Working tree is clean, or changes displayed successfully
1: Error accessing working tree or repository
2: Invalid options or configuration error

Configuration

Status display can be customized:

[status]
# Show short format by default
short = false

# Always show branch information
show_branch = true

# Show untracked files
show_untracked = "normal"  # normal | no | all

# Color output
color = "auto"  # auto | always | never

[status.preview]
# Show compression preview for staged files
compression = true

# Show deduplication opportunities
deduplication = true

# Show storage backend status
backend = true

Notes

Working Tree States

Clean: No changes, nothing to commit
Modified: Changes exist but not staged
Staged: Changes ready for commit
Conflicted: Merge conflicts need resolution
Detached: HEAD not on a branch tip

Performance Tips

Use --short for faster output in scripts
Use --porcelain for machine parsing
Use .mediagitignore to permanently exclude build artifacts and temp files from appearing as untracked
Use --ignored to audit which files are currently excluded by .mediagitignore
Enable status caching for very large repositories

Media File Tracking

MediaGit provides enhanced status for media files:

Automatic format detection (video, image, audio)
Codec and quality information
Resolution and duration metadata
Compatibility warnings for unsupported formats

Keyboard shortcuts

MediaGit-Core Documentation