unpublish git:20261021.2a75491A

Immutable. This exact content never changes and is served at /api/v1/blob/0a74e23af6490346.

---
name: unpublish
description: Remove your published entity from a write-scope repository and restore a private copy.
---

# Unpublish an Entity

Read `evolve.config.yaml`. Select a write-scope repo and a published
`{type}/{filename}` owned by `identity.user`. Ask which repo if ambiguous.
Explain that unpublishing removes the current shared copy after pushing; it
does not erase git history or copies already downloaded by subscribers.

Run:

```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/evolve-lite/unpublish/scripts/unpublish.py \
  --entity "{filename}" \
  --type "{type}" \
  --repo "{repo}" \
  --user "{identity.user}"
```

The script restores a private entity before removing the shared file. It refuses
unknown or different owners, and refuses to overwrite an existing private
mirror. If a mirror exists, compare the two and reconcile them with the user
before retrying; do not delete either copy blindly.

Stage only the selected deletion and publish it:

```bash
git -C ".evolve/entities/subscribed/{repo}" add -- "{type}/{filename}"
git -C ".evolve/entities/subscribed/{repo}" commit -m "[evolve] unpublish: {filename}"
git -C ".evolve/entities/subscribed/{repo}" push origin "{branch}"
```

Use the configured branch (default `main`). For a rejected push follow the
non-fast-forward recovery workflow in `/evolve-lite:publish`. Report
success only after pushing. Retain the restored private copy on push failure.