# Agent notes

Your agent leaves a session handoff on the dashboard and a few notes on the Product page, and the next session starts from them.

Agent notes are what your connected agent writes down for you and for its next session. A **session handoff** says where a session stopped, and the latest one has its own card on the [dashboard](https://getfrostbyte.dev/docs/dashboard#read-the-session-handoff), between the active release and Recent Activity. Up to five **notes** hold things that aren't tasks, and they sit under **Context** on the [Product](https://getfrostbyte.dev/docs/product) page.

**When to use it.** The handoff is for where a session stopped: what's half done, what to try next, what to watch out for. A note is for context that outlives one task, such as how the app is put together. Work to do belongs in [tasks](https://getfrostbyte.dev/docs/tasks) and [releases](https://getfrostbyte.dev/docs/releases), and what you're building and why belongs in the Product Brief.

## Get a session handoff

Once your agent is [connected](https://getfrostbyte.dev/docs/connect-your-agent), ask it when you finish for the day:

> Write a session handoff in Frostbyte.

The agent also writes one itself when it stops with work unfinished. The newest handoff shows in its own card on the dashboard, marked **New** until you've read it, with a dot beside **Dashboard** in the sidebar. Choose the card to read the whole handoff. Tasks it names, such as FB-12, are links: hover one for its title, or choose it to open the task.

The next session gets the handoff back with its first read of the project, with the date it was written. You don't need to paste it in or point the agent at a file.

## Find an earlier handoff

Frostbyte keeps the last three handoffs for a project, so two sessions running side by side don't overwrite each other. Each shows in **Recent Activity** as "left a handoff", and choosing the line opens it. The next session is told about them too.

## Read a note

Open **Product** and find **Context**. Each row shows a note's title, which agent wrote it and when. Choose a row to open it.

Notes and handoffs are read-only in Frostbyte. To change a note, ask your agent. To remove one, open it, then choose **Delete** from the **⋯** menu.

## Move a build plan in

If your agent keeps a plan in a file such as `buildplan.md`, the plan itself belongs in tasks and releases, where the dashboard and **What's Next** can use it. For a new, empty project, use the [set-up prompt](https://getfrostbyte.dev/docs/import-export#set-up-from-your-repo-with-your-agent). For a project that already has tasks, ask your agent:

> Copy my buildplan.md into Frostbyte. Make a release for each phase and put its tasks in it, keep every title exactly as written, carry over what's done, and don't change or delete the file.

Anything in the file that isn't work to do, such as how the pieces fit together, can stay as a note:

> Keep the architecture section as a note in Frostbyte.

## Things to note

- **A handoff older than 7 days leaves the dashboard.** Recent Activity still opens it, and the next session still gets it.
- **Up to five notes per project**, each up to 100,000 characters. A handoff holds up to 4,000. Agent notes work on every plan.
- **Any member can read and delete a note or a handoff.** Deleting can't be undone.
- **Links open in a new tab, and images show as links.** Links to files on your computer show as plain text, since a browser can't open them.

## Related

- [Connect your agent](https://getfrostbyte.dev/docs/connect-your-agent): set up the agent that writes the notes.
- [Working with your agent](https://getfrostbyte.dev/docs/agent-capabilities): everything a connected agent can read and change.
- [MCP server](https://getfrostbyte.dev/docs/mcp-server): the `session_end`, `list_notes`, `get_note` and `write_note` tools.