> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bijection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bijection agents

> Inspect the agents this deployment runs

## bijection agents

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Inspect the agents this deployment runs

Usage:
  bijection agents [flags]
  bijection agents [command]

Available Commands:
  describe    Show an agent's session policy and tools
  list        List declared agents
  runs        Inspect and cancel agent runs

Flags:
  -h, --help   help for agents

Global Flags:
      --help-all   Show all commands and options, including administrative controls.

Use "bijection agents [command] --help" for more information about a command.
```

## bijection agents describe

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Show an agent's session policy and tools

Usage:
  bijection agents describe <agent> [flags]

Flags:
      --deployment string   Inspect agents on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
  -h, --help                help for describe
      --help-all            Show all commands and options, including administrative controls.
      --json                Print the declaration as JSON.
      --module string       The module exporting agentsModule. Defaults to agents.
      --prod                Inspect agents on this project's default production deployment.
```

## bijection agents list

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
List declared agents

Usage:
  bijection agents list [flags]

Flags:
      --deployment string   Inspect agents on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
  -h, --help                help for list
      --help-all            Show all commands and options, including administrative controls.
      --json                Print the declaration as JSON.
      --module string       The module exporting agentsModule. Defaults to agents.
      --prod                Inspect agents on this project's default production deployment.
```

## bijection agents runs

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Inspect and cancel agent runs

Usage:
  bijection agents runs [flags]
  bijection agents runs [command]

Available Commands:
  cancel      End a run's authority and prevent further committed work
  get         Read a run's current execution state
  list        List your latest 50 agent runs

Flags:
  -h, --help   help for runs

Global Flags:
      --help-all   Show all commands and options, including administrative controls.

Use "bijection agents runs [command] --help" for more information about a command.
```

## bijection agents runs cancel

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
End a run's authority and prevent further committed work

Usage:
  bijection agents runs cancel <run> [flags]

Flags:
      --deployment string   Use agent runs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
  -h, --help                help for cancel
      --help-all            Show all commands and options, including administrative controls.
      --json                Print the run as JSON.
      --module string       The module exporting agentsModule. Defaults to agents.
      --prod                Use agent runs on this project's default production deployment.
```

## bijection agents runs get

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Read a run's current execution state

Usage:
  bijection agents runs get <run> [flags]

Flags:
      --deployment string   Use agent runs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
  -h, --help                help for get
      --help-all            Show all commands and options, including administrative controls.
      --json                Print the run as JSON.
      --module string       The module exporting agentsModule. Defaults to agents.
      --prod                Use agent runs on this project's default production deployment.
```

## bijection agents runs list

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
List your latest 50 agent runs

Usage:
  bijection agents runs list [flags]

Flags:
      --deployment string   Use agent runs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
  -h, --help                help for list
      --help-all            Show all commands and options, including administrative controls.
      --json                Print the run as JSON.
      --module string       The module exporting agentsModule. Defaults to agents.
      --prod                Use agent runs on this project's default production deployment.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.