# Fir sessions

> Every agent's work is a Fir session, one record kept by Fir for any agent: every message, tool call, edit, command, test run, decision, compaction and handoff, with who did each and what it cost. An agent's commit needs an open session; a person's own is suggested one by default. Sessions resume on any machine or harness, rewind to an event with nothing deleted, and improve Frazer's products only when your organization opts in. Every command is in the Fir CLI reference: https://frazer.ai/docs/source/reference/cli.md.

Part of Frazer's docs for agents. Every page on frazer.ai: https://frazer.ai/llms.txt. Every docs page: https://frazer.ai/docs/llms.txt.

## How agents should use Fir sessions

- Open a session before you work (`fir session open`, or your harness's Fir plugin), keep it current, checkpoint before a long wait and close it with an outcome. Read a summary's handles with `read_session` when the task depends on the full text.
- On `SESSION_REQUIRED` (exit `5`), run the `next` call it prints, then commit again. Never use a bypass grant you were not given.
- Before you resume an idle session, read its cost with `fir session resume <session> --dry-run`; to undo a wrong turn, `fir session rewind <session> --to <event>`.

## Pages

- [Sessions for any agent](https://frazer.ai/docs/sessions.md?from=llms-txt): One record of every agent's work, kept by Fir, for any agent: an append-only log that compaction never shortens, open to every harness through one protocol, required for an agent's commits, resumable on any machine or harness, a successor that brings memory back after a restart, and every session shown under its plan, campaign and workspace.

## Optional

- [Full text of these pages](https://frazer.ai/docs/sessions/llms-full.txt): 1 pages, 35,351 characters, about 8,838 tokens