Unstage a file while keeping its contents.

Git: Unstage a file while keeping its contents inside the disposable repository created by the input setup.

Shell terminal
printf 'changed\n' >> lesson.txt
git add -- lesson.txt
git restore --staged -- lesson.txt
git status --short

Expected output EXAMPLE

 M lesson.txt

Details

Requires Git and Bash. Run in a disposable practice repository. The test setup below creates the starting files and commits.

Keep in mind

Use a disposable practice directory. The setup configures a synthetic author locally for this repository only; it does not change global Git settings.

✓ Verified

Tested on Ubuntu 24.04.5 LTS · · git version 2.43.0 · bash 5.2.21-2ubuntu4; coreutils 9.4-3ubuntu6.3

Test inputs, results and environment

The exact published code ran in a dedicated Linux test container with prepared inputs. Snippet process uid 65534 with a read-only root filesystem and temporary working files. Networking disabled. Fixtures and output records are isolated from the application database. Testing covers this example and its stated checks, not every input, operating system, or runtime version. The Linux container shares its host's kernel; this is not a native Windows test.

Architecture / host kernel
x86_64 / 6.18.54.1-microsoft-standard-WSL2
Snippet identity / locale
uid=65534, gid=65534 (unprivileged process) / C.UTF-8
Interpreter invocation
bash -euo pipefail -c <published code>
Container image ID
sha256:ec91410a8f6ec3e985830b5e3a0560306d36f8c1c5ccd91a6699abe707123fa3
Code SHA-256
b21a448a261aea3c3655cdd322f96ad327615387583e87cf826532407d20b473
Dependencies
bash 5.2.21-2ubuntu4; coreutils 9.4-3ubuntu6.3

Test input setup

These are the prepared inputs used by the test harness. See Details above for the prerequisites and how to run this example.

git init -q -b main
git config user.name 'Practice User'
git config user.email 'learner@example.invalid'
git config commit.gpgsign false
printf 'first\n' > lesson.txt
git add lesson.txt
git commit -qm 'First lesson'

Observed standard output

 M lesson.txt

Exit code: 0. Standard error: empty. Validation: Exact stdout comparison. System-dependent values above are one recorded run.