Skip to the content.

ivaldi status

Display the current state of the working directory and staging area.

Synopsis

ivaldi status

Description

The status command shows:

Example Output

$ ivaldi status

Timeline: feature-auth
Last seal: swift-eagle-flies-high-447abe9b

Staged changes:
  modified: src/auth.go
  new file: src/login.go

Unstaged changes:
  modified: src/config.go
  modified: README.md

Untracked files:
  tests/auth_test.go
  .env.local

Working directory: 3 files modified, 1 untracked

File States

Staged

Files ready for next seal:

Staged changes:
  modified: src/auth.go
  new file: src/login.go

Unstaged

Modified but not staged:

Unstaged changes:
  modified: src/config.go

Untracked

New files not in version control:

Untracked files:
  tests/new_test.go

Common Workflows

Check Status Before Commit

ivaldi status
ivaldi gather .
ivaldi seal "Update features"

Verify Staging

ivaldi gather src/
ivaldi status  # Verify correct files staged
ivaldi seal "Update source files"

Review Changes

ivaldi status  # See what changed
ivaldi diff   # See specific changes

Clean Working Directory

When everything is committed:

$ ivaldi status

Timeline: main
Last seal: brave-wolf-runs-fast-abc12345

Working directory: clean

Comparison with Git

Git Ivaldi
git status ivaldi status
Shows branch Shows timeline
Staged/unstaged Staged/unstaged
Untracked Untracked

Tips