| sidebar_position | 6 |
|---|---|
| title | status |
Show the status of the working copy.
atomic status [OPTIONS] [PATH]The status command displays a summary of the current state of your working copy compared to the last recorded state. It shows which files have been added, modified, deleted, or renamed, along with untracked files.
This command is designed to give you a quick overview of what has changed before you record. Unlike atomic diff, which shows the actual content changes, status provides a concise summary of which files are affected.
Show status for a specific path only.
atomic status src/Show short/porcelain output. This provides a compact listing with two-character status codes.
atomic status -sOutput format:
A new_file.rs # Added
M modified_file.rs # Modified
D deleted_file.rs # Deleted
MV renamed_file.rs # Moved/Renamed
C conflicted.rs # Conflicted (unresolved merge)
?? untracked.txt # Untracked
Don't show untracked files. By default, untracked files are included in the output.
atomic status --no-untrackedRebuild the FILE_INDEX before computing status.
atomic status --reindexThese options are available on all commands:
-v, --verbose- Emit extra diagnostic output--no-color- Disable ANSI color in output-h, --help- Print help-V, --version- Print version
# Show status of the working copy
atomic statusOutput:
On view main
State: ABCD1234EFGH5678
Changes to be recorded:
(use "atomic restore <file>..." to discard changes)
new file: src/new_feature.rs
modified: src/main.rs
deleted: src/deprecated.rs
When there are no changes:
atomic statusOutput:
On view main
State: ABCD1234EFGH5678
nothing to record, working tree clean
atomic status -sOutput:
A src/new_feature.rs
M src/main.rs
D src/deprecated.rs
atomic status --no-untrackedatomic status src/# Force a rebuild of the FILE_INDEX before computing status
atomic status --reindexIn the default long format, changes are grouped by type with descriptive labels:
| Label | Description |
|---|---|
new file: |
File added to tracking |
modified: |
File contents changed |
deleted: |
File removed |
renamed: |
File moved or renamed |
conflicted: |
File has unresolved conflict markers |
In short format (-s), two-character codes are used:
| Code | Description |
|---|---|
A |
Added |
M |
Modified |
D |
Deleted |
MV |
Moved/Renamed |
C |
Conflicted (unresolved merge) |
?? |
Untracked |
A C entry supersedes any M for the same file: a conflicted file is never
reported as merely modified. See Merging & Conflicts
for how conflicts are surfaced and resolved.
- Merging & Conflicts - Understand conflicted (
C) files atomic diff- Show detailed content differencesatomic record- Record changes after reviewing statusatomic add- Add untracked files to trackingatomic restore- Discard working copy changesatomic log- View history of recorded changes