gitnexus status

​

Syntax

gitnexus status

​

Description

• Checks if the current directory is a git repository
• Looks up the repository in the global registry
• Compares the indexed commit with the current commit
• Reports whether the index is up-to-date or stale

​

Output Example

​

Up-to-date index

Repository: /Users/dev/projects/my-app
Indexed: 2/28/2026, 10:30:00 AM
Indexed commit: a3f9c21
Current commit: a3f9c21
Status: ✅ up-to-date

​

Stale index

Repository: /Users/dev/projects/my-app
Indexed: 2/27/2026, 3:45:00 PM
Indexed commit: b8e2d44
Current commit: a3f9c21
Status: ⚠️ stale (re-run gitnexus analyze)

​

Not indexed

Repository not indexed.
Run: gitnexus analyze

​

Not a git repository

Not a git repository.

​

When Index is Stale

• New commits are made after indexing
• Files are modified but not committed (the index only tracks committed state)
• Branches are switched

gitnexus analyze

​

Use Cases

​

Before using MCP tools

gitnexus status

​

CI/CD integration

gitnexus status
if [ $? -ne 0 ]; then
  gitnexus analyze
fi

​

After switching branches

git checkout feature-branch
gitnexus status
# If stale:
gitnexus analyze

​

What Gets Checked

• Repository path — Absolute path to the git root
• Indexed timestamp — When the index was last built
• Indexed commit — Git SHA that was indexed (first 7 characters)
• Current commit — Current git HEAD (first 7 characters)
• Status — Whether the commits match

​

Related Commands

• gitnexus analyze — Update the index
• gitnexus list — List all indexed repositories
• gitnexus clean — Delete the index