---
title: Session
order: 1
description: "An agent host's conversation, by the id the host delivers to its hooks. magus never mints one: a record with no session is unattributed, and the OS user it carries says whose account ran it."
tags: [glossary, sessions-and-leases]
---

# Session

An agent host's conversation, by the id the host delivers to its hooks. magus
never mints one: a record with no session is unattributed, and the OS user it
carries says whose account ran it.

## Elsewhere

A web session is authenticated state behind a cookie. Agent hosts mean the conversation, which
is the sense magus takes; magus reads the host's id and never makes one up.

## Example

```sh
magus session --brief
```

## Used in

<!-- BEGIN GLOSSARY USAGE (generated by glossary-usage-generate from the knowledge graph; edit the generator, not this list) -->

In the docs:

- [Agent contact (@session)](../concepts/knowledge.md#agent-contact-session)
- [When a session loses its history](../guides/integrations/agents.md#when-a-session-loses-its-history)
- [Handing a session its state back](../guides/integrations/agents/any-host.md#handing-a-session-its-state-back)
- [Handing a compacted session its state back](../guides/integrations/agents/claude-code.md#handing-a-compacted-session-its-state-back)
- [Relationship to magus session hook](../guides/integrations/editor/design.md#relationship-to-magus-session-hook)
- [GetSessionActivity](../reference/api/viewer/v1alpha1/viewer.md#getsessionactivity)

In the code (`magus refs <name>` lists every site):

- `broker.session` (Go)
- `tty.session` (Go)
- `buzz.session` (Go)
- `engine.Session` (Go)
- `service.Session` (Go)

<!-- END GLOSSARY USAGE -->

## See also

- [Invocation](invocation.md)
- [Window](window.md)