fenbs_save_progress
Save progress -- the hand off. Call it before you stop, when the person says "save progress" or "hand off", or before a window is cleared. In one call: where each task you touched stands (overwrites its Where it stands; the old text is kept, and fenbs_get_item shows it) and the steps it ticked (doneSteps), and, with project, where the project was left: what to start on next, what is still running (stop it first if you can), and what is waiting on a person. The next assistant reads all of it in fenbs_get_context. Never put a secret in it. Needs permission to change tasks.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| drop | No | Only with append and onOverflow ask: entry numbers to drop, 1-based, with the returned basis. Entries are blocks between blank lines, not whole handoffs; read firstLine before choosing. | |
| basis | No | Only with append, onOverflow ask and drop: the returned hash of the exact current text. A stale basis holds the text and returns fresh entries and a new basis. | |
| tasks | No | One entry per task you worked on. | |
| append | No | true: add whereWeLeftOff after what is already there (a blank line between) instead of replacing it -- for adding a step to a plan another session left. Past 4000 characters the oldest entries are dropped to make room, and the reply says how many. Rewrite it whole when the old text is out of date. | |
| status | No | The project's overall progress in a few lines. Replaces the last one; leave out to keep it. | |
| project | No | The project, by name, for whereWeLeftOff and status. | |
| session | No | A short name for this session or window, e.g. "Claude Code c--ws 33edc07d". Pass the same one on every call. Every window you open shares this connection, so without it fenbs shows only the connection name and cannot tell your windows apart. | |
| takeover | No | The session you are taking over from, when it handed the task to you without releasing it (it crashed, or was cleared without a final save). If it names the session working the task, you take it over with no warning and the history notes the handover; if not, you get the usual warning. Applies to every task in this call. | |
| onOverflow | No | With append: trim drops the oldest entries to fit (the default). ask holds only whereWeLeftOff when it would overflow; task updates and project status still save. Read the returned entries, then retry with drop and basis, or rewrite it whole without append. Successful appends return room and a warning below 800 characters left. | trim |
| whereWeLeftOff | No | Start here next; still running; waiting on a person; anything across tasks. Replaces the last one, unless append is true. |