---
title: Invocation
order: 2
description: "One magus process's recorded facts (the targets it finished, their outcomes, the lease it acted as, and the session it ran in when a host delivered one), kept in a repo-scoped store every worktree shares. magus session lists them; the store prunes itself by last-fact age."
tags: [glossary, sessions-and-leases]
---

# Invocation

One magus process's recorded facts (the targets it finished, their outcomes,
the lease it acted as, and the session it ran in when a host delivered one),
kept in a repo-scoped store every worktree shares. `magus session` lists them;
the store prunes itself by last-fact age.

## Elsewhere

A serverless platform calls one execution of a function an invocation (AWS Lambda). A magus
invocation is one `magus` process, and what it records outlives it.

## Example

```sh
magus session ls
```

## Used in

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

In the docs:

- [ADR 0001: bounded concurrency with recursive invocation](../decisions/0001-bounded-concurrency-with-recursive-invocation.md#adr-0001-bounded-concurrency-with-recursive-invocation)
- [ADR 0003: running an invocation on another operating system](../decisions/0003-running-an-invocation-on-another-operating-system.md#adr-0003-running-an-invocation-on-another-operating-system)
- [Recursive invocation](../guides/tips.md#recursive-invocation)
- [GetInvocation](../reference/api/viewer/v1alpha1/viewer.md#getinvocation)
- [MGS3012: invocation stalled](../reference/codes/sandbox/MGS3012.md#mgs3012-invocation-stalled)

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

- `hint.Invocation` (Go)
- `journal.Invocation` (Go)
- `magus.Invocation` (Go)

<!-- END GLOSSARY USAGE -->

## See also

- [Session](session.md)
- [Run](run.md)