Usage
Description
Display the current status of your VibeHub repository, including sync state, connected project, and pending changes.
Options
Show detailed status information including file lists.
Output status in JSON format for scripting.
Examples
Basic Status
Verbose Status
JSON Output
Output
Connected and Synced
VibeHub Status
─────────────
Project: username/my-project
Branch: main
Status: ✓ Up to date
Last push: 2 hours ago
Last pull: 2 hours ago
Changes Pending
VibeHub Status
─────────────
Project: username/my-project
Branch: main
Status: ⚠ Changes not pushed
Local changes:
• 3 commits ahead
• 5 files modified
Run 'vibe push' to sync.
Not Connected
VibeHub Status
─────────────
Status: ✗ Not connected
Run 'vibe set <project-url>' to connect to a project.
Not Initialized
VibeHub Status
─────────────
Status: ✗ Not initialized
Run 'vibe init' to set up VibeHub in this directory.
Status Indicators
| Indicator | Meaning |
|---|
| ✓ Up to date | Local and remote are in sync |
| ⚠ Changes not pushed | Local commits need to be pushed |
| ⚠ Behind remote | Remote has commits you don’t have |
| ✗ Not connected | No VibeHub project connected |
| ✗ Not initialized | VibeHub not set up in this directory |
Verbose Output
With --verbose, you’ll also see:
VibeHub Status (verbose)
───────────────────────
Project: username/my-project
URL: https://vibehub.co.in/username/my-project
Branch: main
Status: ⚠ Changes not pushed
Local commits (not pushed):
• abc1234 - Add user authentication
• def5678 - Fix login bug
• ghi9012 - Update readme
Modified files:
• src/auth.js
• src/login.js
• README.md
• package.json
• tests/auth.test.js
Run 'vibe push' to sync.
JSON Output
For scripting and automation:
{
"initialized": true,
"connected": true,
"project": {
"name": "my-project",
"owner": "username",
"url": "https://vibehub.co.in/username/my-project"
},
"branch": "main",
"synced": false,
"commitsAhead": 3,
"commitsBehind": 0,
"modifiedFiles": 5
}
Use Cases
Check status to see what will be pushed:vibe status --verbose
vibe push
Use verbose mode to understand sync state:
Use JSON output in scripts:if vibe status --json | jq -e '.synced == false'; then
vibe push
fi
