organic-os reset (guided teardown)
organic-os never deletes anything irreversible automatically. This skill
walks the user through everything that exists for a site and what to do
about each piece, then only touches the local registry with explicit
confirmation.
Step 1: show what exists
- Read
~/.config/organic-os/sites.yaml via core.registry.load(): list
every registered site (slug, name, url, brain path) and which one is
active.
- List files in
~/.config/organic-os/ - the per-site env files
(<slug>.env, holding WP_APP_PASSWORD / TELEGRAM_BOT_TOKEN) and the
registry file itself.
- For the site the user is asking about: report whether its brain path
exists on disk and whether it is a git repo (has a remote or not).
Step 2: ask which site to tear down
AskUserQuestion: which registered site (or "all"). Confirm before any write.
Step 3: walk through each piece, per site
Only items 2 and 6 below are things this skill performs, each only with
explicit confirmation. Everything else is the user's own action - state why
for each.
- Scheduled routines: point at the runtime's own mechanism. If runtime
mode is
claude-scheduled, tell the user to remove the scheduled task from
their Claude scheduler. If ci, tell them to disable/delete the workflow
file or cron entry in their CI system. organic-os does not manage the
runtime's own scheduler and cannot deregister a routine for them.
- Registry entry: with explicit confirmation, remove the site from
~/.config/organic-os/sites.yaml by calling core.registry.unregister(<slug>).
If the removed site was active, tell the user no site is active until
they register or switch to another one.
- Brain repo: organic-os never deletes it, on this skill's own authority
or the user's request in this session. It is the site's memory - signals,
decisions, reflections, skillbook, outcomes - and often has git history the
user wants to keep or archive. Tell the user the exact path and how to
remove it themselves:
rm -rf <brain-path> for the local copy, plus
deleting the remote repo from GitHub/GitLab settings if it was pushed.
- WordPress Application Password: organic-os cannot revoke it. Tell the
user: WP Admin > Users > Profile > Application Passwords, revoke the one
created for organic-os.
- Telegram bot token: if the approval channel was telegram, tell the
user they can revoke/regenerate it via @BotFather's
/revoke command if
they want to fully cut access. Deleting the env file alone stops polling
but does not invalidate the token.
- Env file: with explicit confirmation, delete
~/.config/organic-os/<site-slug>.env.
Step 4: summarize
State plainly what was done automatically in this session (registry
deregistration, env file deletion - only if confirmed) versus what the user
must still do by hand (brain repo deletion, WordPress application-password
revocation, Telegram token revocation, scheduler cleanup) and exactly where
to do each.
Rules
- Uninstalling the plugin itself never deletes any brain repo - brains are
ordinary git repos or folders that live outside the plugin's install
location. State this explicitly if asked "does uninstalling delete my
data".
- Never delete a brain repo under any instruction in this skill - that
action is reserved for the user, always.
- Never revoke a WordPress application password or a Telegram bot token on
the user's behalf - point them at the UI where they can do it themselves.
- Never delete or edit the registry, or an env file, without an explicit
confirmation for that specific site in this session.
1---2name: reset3description: Use when the user wants to remove a site from organic-os, deregister a site, uninstall, "reset organic-os", "remove my site", "start over", or runs /organic-os:reset. Guided teardown that shows what exists and, per user choice, deregisters the site from the local registry - it never deletes the brain repo or revokes credentials on the user's behalf.4---56# organic-os reset (guided teardown)78organic-os never deletes anything irreversible automatically. This skill9walks the user through everything that exists for a site and what to do10about each piece, then only touches the local registry with explicit11confirmation.1213## Step 1: show what exists14151. Read `~/.config/organic-os/sites.yaml` via `core.registry.load()`: list16 every registered site (slug, name, url, brain path) and which one is17 active.182. List files in `~/.config/organic-os/` - the per-site env files19 (`<slug>.env`, holding `WP_APP_PASSWORD` / `TELEGRAM_BOT_TOKEN`) and the20 registry file itself.213. For the site the user is asking about: report whether its brain path22 exists on disk and whether it is a git repo (has a remote or not).2324## Step 2: ask which site to tear down2526AskUserQuestion: which registered site (or "all"). Confirm before any write.2728## Step 3: walk through each piece, per site2930Only items 2 and 6 below are things this skill performs, each only with31explicit confirmation. Everything else is the user's own action - state why32for each.33341. **Scheduled routines**: point at the runtime's own mechanism. If runtime35 mode is `claude-scheduled`, tell the user to remove the scheduled task from36 their Claude scheduler. If `ci`, tell them to disable/delete the workflow37 file or cron entry in their CI system. organic-os does not manage the38 runtime's own scheduler and cannot deregister a routine for them.392. **Registry entry**: with explicit confirmation, remove the site from40 `~/.config/organic-os/sites.yaml` by calling `core.registry.unregister(<slug>)`.41 If the removed site was active, tell the user no site is active until42 they register or switch to another one.433. **Brain repo**: organic-os never deletes it, on this skill's own authority44 or the user's request in this session. It is the site's memory - signals,45 decisions, reflections, skillbook, outcomes - and often has git history the46 user wants to keep or archive. Tell the user the exact path and how to47 remove it themselves: `rm -rf <brain-path>` for the local copy, plus48 deleting the remote repo from GitHub/GitLab settings if it was pushed.494. **WordPress Application Password**: organic-os cannot revoke it. Tell the50 user: WP Admin > Users > Profile > Application Passwords, revoke the one51 created for organic-os.525. **Telegram bot token**: if the approval channel was telegram, tell the53 user they can revoke/regenerate it via @BotFather's `/revoke` command if54 they want to fully cut access. Deleting the env file alone stops polling55 but does not invalidate the token.566. **Env file**: with explicit confirmation, delete57 `~/.config/organic-os/<site-slug>.env`.5859## Step 4: summarize6061State plainly what was done automatically in this session (registry62deregistration, env file deletion - only if confirmed) versus what the user63must still do by hand (brain repo deletion, WordPress application-password64revocation, Telegram token revocation, scheduler cleanup) and exactly where65to do each.6667## Rules6869- Uninstalling the plugin itself never deletes any brain repo - brains are70 ordinary git repos or folders that live outside the plugin's install71 location. State this explicitly if asked "does uninstalling delete my72 data".73- Never delete a brain repo under any instruction in this skill - that74 action is reserved for the user, always.75- Never revoke a WordPress application password or a Telegram bot token on76 the user's behalf - point them at the UI where they can do it themselves.77- Never delete or edit the registry, or an env file, without an explicit78 confirmation for that specific site in this session.