Docs CLI devsafe status

devsafe status

Shows backup status for every discovered repository on your machine. One command, one table: repository name, health score, and last snapshot time.

Paid feature

Usage

terminal

$ devsafe status

No flags required. DevSafe walks your configured project directories, finds every git repository, and prints a summary table.

Example output

terminal

$ devsafe status
repository             health   last snapshot
─────────────────────────────────────────────
api-server               100   2 minutes ago
design-tokens             97   3 minutes ago
marketing-site            99   just now
mobile-app                95   8 minutes ago
shared-utils             100   1 minute ago
billing-service           92   14 minutes ago
docs-site                100   5 minutes ago

✓ 7 repos · health 97 · watcher healthy

The summary line at the bottom shows the total number of discovered repositories, the average health score across all repos, and whether the background watcher process is running.

Health score

Each repository gets a health score from 0 to 100. The score measures how completely your latest snapshot covers the current state of the repository. A score of 100 means the snapshot includes everything: all committed history (the git bundle) and all uncommitted work.

What the score includes

Committed state (git bundle coverage). Does the latest snapshot contain all branches, tags, and objects in the repository?
Uncommitted state (five-namespace capture). Does the snapshot include your staged changes, unstaged edits, untracked files, stash entries, and any in-progress operations like merges or rebases?

A health score below 100 typically means you have recent uncommitted changes that have not been captured yet. The watcher will pick them up on the next cycle (usually within seconds).

Score ranges

95-100: Fully protected. Your snapshot is current.
80-94: Mostly protected. Some recent changes are not yet captured.
Below 80: Gaps exist. Check that the watcher is running with devsafe status and look at the "watcher healthy" indicator in the summary line.

Health scores update in real time.

Run devsafe status again after a few seconds and you will see scores climb as the watcher captures your latest changes. If a score stays low, the watcher may have stopped. Restart it with devsafe backup.

Last snapshot

The "last snapshot" column shows a human-readable timestamp for when DevSafe last created an encrypted git bundle for that repository and uploaded it to your user-owned storage. Timestamps display as relative times ("just now", "3 minutes ago", "2 hours ago") for recent snapshots, and as full dates for older ones.

If a repository shows "never" in this column, it has been discovered but not yet backed up. Run devsafe backup to trigger the first snapshot.

Install

If you have not installed DevSafe yet, the quickest way on macOS is Homebrew.

macos · homebrew

$ brew install hxalabs/tap/devsafe

See the Quickstart for full install instructions on all platforms.