# Cursor IDE — second laptop / agent handoff

Cursor does not ship a single “export entire IDE” button. Use this checklist to move **code + rules + agent chat history** to another machine.

## 1. Code (required)

On the **new** laptop, follow [FRESH_ENV_CLONE.md](FRESH_ENV_CLONE.md) (`~/repos/ac`).

## 2. Workspace rules (recommended)

Copy from the old machine:

| Source | Destination on new laptop |
|--------|---------------------------|
| `~/repos/ac/.cursor/rules/` (if present) | same under workspace |
| `~/repos/ac/AGENTS.md` | workspace root |

Or re-clone — rules live in `ac-docs` / monolith exports when committed.

## 3. Agent conversation history

Cursor stores transcripts per project, e.g.:

`~/.cursor/projects/<project-slug>/agent-transcripts/*.jsonl`

**Handoff archive** (run on the **old** laptop from repo root):

```bash
cd ~/repos/ac
tar czvf ~/ac-cursor-handoff-$(date +%Y%m%d).tar.gz \
  .cursor/rules 2>/dev/null \
  AGENTS.md 2>/dev/null \
  -C "$HOME/.cursor/projects" \
  $(ls -1d "$HOME/.cursor/projects"/*androidcast* 2>/dev/null | xargs -I{} basename {})
```

Copy the `.tar.gz` to the new laptop and extract:

```bash
mkdir -p ~/.cursor/projects
tar xzvf ac-cursor-handoff-YYYYMMDD.tar.gz -C ~
```

Open **`~/repos/ac`** in Cursor on the new machine — past chats appear under that project when the slug matches.

## 4. What is *not* portable

- Local Cursor login / API keys (re-sign-in)
- Uncommitted work (commit or stash before switch)
- Cluster secrets (`secrets.lab.env` on NFS — not in git)

## 5. Scripted helper

`ac-scripts/export-cursor-handoff.sh` — builds the tarball paths above.