---
name: os-switch-project
description: Switch the active project. Optionally saves the current session and instructs the user to clear context. Run /os-start in the new session to choose a project and load context.
---

# /os-switch-project — Switch Project

Cleanly switches from the current active project to a new one across a context boundary.

---

## Step 1 — Offer to save current session

Ask:
```
Switching projects.

Save this session before switching? (Y/n)
```

If yes: run `/os-save`.
If no: continue.

---

## Step 2 — Choose new project

Read `projects.md` and list all Active projects. Count them, then add one final option dynamically:

```
Switch to which project?

1. [Project Name]
2. [Project Name]
3. [Project Name]
[...all active projects from projects.md...]
N. Add a new project
```

Wait for selection.

---

## Step 3 — Handle selection

### If an existing project is selected:

If the user skipped `/os-save` in Step 1, update the `Last session:` field for that project in `projects.md` to today's date.

Print:
```
Now working on [New Project Name].

Run /clear to reset context, then /os-start to load the new project.
```

### If "Add a new project" is selected:

Run `/os-new-project`.

---

## Notes

- There is no longer an "Active project" line in root `CLAUDE.md`. Project selection happens at `/os-start` time.
- The switch takes effect after `/clear`. Run `/os-start` in the new session to select and load a project.