---
title: Job
order: 6
description: "The unit of delegated work, and one row of the job store: what an orchestrating agent handed out, with its goal, the checkpoint it was cut against, the paths it may write or must not touch, and the one check it runs. A job's holder is either a session, for work an orchestrator handed out, or the daemon, for its own maintenance. The store records; the agent guard is what reads those facts back when grading a write."
tags: [glossary, sessions-and-leases]
---

# Job

The unit of delegated work, and one row of the job store: what an orchestrating
agent handed out, with its goal, the checkpoint it was cut against, the paths it
may write or must not touch, and the one check it runs. A job's holder is either
a session, for work an orchestrator handed out, or the daemon, for its own
maintenance. The store records; the agent guard is what reads those facts back
when grading a write.

A job is not a run. `magus run build web` is a run, and no job exists for it. A
job causes runs: its check executes as one, and a daemon job records the
invocation of its last one. Jobs are listed with `magus ls jobs` and in the
console's Jobs view; runs are listed in the Runs view.

## Elsewhere

A GitHub Actions job is a set of steps on one runner; a Kubernetes Job runs pods to
completion; a cron job runs on a schedule. A magus job is delegated work with a boundary: the
paths it may write and the one check that says it is done.

## Example

```sh
magus ls jobs
```

## Used in

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

In the docs:

- [2026-10-23: a job pauses, and leans by weight](../decisions/0001-bounded-concurrency-with-recursive-invocation.md#2026-10-23-a-job-pauses-and-leans-by-weight)
- [Asking where a job stands](../guides/integrations/agents/leases.md#asking-where-a-job-stands)
- [The job store is one jobs.jsonl per repository](../guides/integrations/agents/orchestration.md#the-job-store-is-one-jobsjsonl-per-repository)
- [Which tier a job gets](../guides/jobs/model-tiers.md#which-tier-a-job-gets)
- [Job](../reference/api/job/v1alpha1/job.md#job)
- [MGS3018: a directory as a job write path](../reference/codes/sandbox/MGS3018.md#mgs3018-a-directory-as-a-job-write-path)

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

- `magus\Job` (Buzz host type)
- `types.Job` (Go)

<!-- END GLOSSARY USAGE -->

## See also

- [Design principles](../design.md)
- [Lease](lease.md)
- [Run](run.md)