> ## 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 emulation

> Preview reduced access on live data or a private writable sandbox

## bijection emulation

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Create an explicitly named preview of your own narrower authority. Live previews allow reads; sandboxes allow confined mutations. Contexts retain exact scope, session identity, target generation and expiry in private local custody. Select one for supported business commands with --emulation; ordinary sign-in and deployment selection remain independent.

Usage:
  bijection emulation [flags]
  bijection emulation [command]

Available Commands:
  catalog     Discover scope resources, permissions, roles, clearances and eligible presets
  diagnose    Inspect declared dependencies and invocation restrictions under this preview
  end         Stop local execution, then end the native session with retryable cleanup custody
  explain     Explain native access under this preview
  forget      Remove local custody after confirmed termination or an expired pending admission
  list        List your native previews, including sessions whose local context was lost
  resume      Recover the original admission or restore an existing session without extending it
  start       Retain an exact admission request, then create its native preview
  status      Inspect native liveness, fixed scope and sandbox cleanup progress

Flags:
  -h, --help        help for emulation
      --help-all    Show all commands and options, including administrative controls.
      --help-json   Print command input and output schemas as JSON without executing it.

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

## bijection emulation catalog

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Discover scope resources, permissions, roles, clearances and eligible presets

Usage:
  bijection emulation catalog [flags]

Flags:
      --deployment string       Use emulation 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.
      --format string           Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                    help for catalog
      --help-all                Show all commands and options, including administrative controls.
      --help-json               Print command input and output schemas as JSON without executing it.
      --sign-in-client string   Select the installed application client for business sign-in
      --url string              Use emulation on the deployment at the given URL.
```

## bijection emulation diagnose

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Inspect declared dependencies and invocation restrictions under this preview

Usage:
  bijection emulation diagnose <context> [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for diagnose
      --help-all        Show all commands and options, including administrative controls.
      --help-json       Print command input and output schemas as JSON without executing it.
      --input string    JSON object or @path containing application:<installed manifest> or dependencies:[{name,resource:{type,key},permissions:[]}], optional invocation:{function,operation,args}; reports incomplete behavior explicitly
```

## bijection emulation end

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Stop local execution, then end the native session with retryable cleanup custody

Usage:
  bijection emulation end <context> [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for end
      --help-all        Show all commands and options, including administrative controls.
      --help-json       Print command input and output schemas as JSON without executing it.
```

## bijection emulation explain

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Explain native access under this preview

Usage:
  bijection emulation explain <context> [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for explain
      --help-all        Show all commands and options, including administrative controls.
      --help-json       Print command input and output schemas as JSON without executing it.
      --input string    JSON object or @path containing resource:{type,key}, optional permissions and principal
```

## bijection emulation forget

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Remove local custody after confirmed termination or an expired pending admission

Usage:
  bijection emulation forget <context> [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for forget
      --help-all        Show all commands and options, including administrative controls.
      --help-json       Print command input and output schemas as JSON without executing it.
```

## bijection emulation list

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
List your native previews, including sessions whose local context was lost

Usage:
  bijection emulation list [flags]

Flags:
      --cursor string           Continue the original person-scoped listing
      --deployment string       Use emulation 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.
      --format string           Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                    help for list
      --help-all                Show all commands and options, including administrative controls.
      --help-json               Print command input and output schemas as JSON without executing it.
      --limit int               Return 1–100 sessions (default 32)
      --sign-in-client string   Select the installed application client for business sign-in
      --url string              Use emulation on the deployment at the given URL.
```

## bijection emulation resume

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Recover the original admission or restore an existing session without extending it

Usage:
  bijection emulation resume <context> [flags]

Flags:
      --deployment string       Use emulation 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.
      --format string           Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                    help for resume
      --help-all                Show all commands and options, including administrative controls.
      --help-json               Print command input and output schemas as JSON without executing it.
      --session string          Restore a lost context from an exact session ID returned by emulation list
      --sign-in-client string   Select the installed application client for business sign-in
      --url string              Use emulation on the deployment at the given URL.
```

## bijection emulation start

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Retain an exact admission request, then create its native preview

Usage:
  bijection emulation start <context> [flags]

Examples:
  bijection emulation start viewer --scope @viewer-scope.json --target sandbox --expires-in 30m

Flags:
      --deployment string       Use emulation 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.
      --expires-in string       Fixed original lifetime, from 1m to 1h; recovery cannot extend it (default "10m")
      --format string           Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                    help for start
      --help-all                Show all commands and options, including administrative controls.
      --help-json               Print command input and output schemas as JSON without executing it.
      --preset string           An eligible installed preset returned by emulation catalog
      --request-id string       Exact random admission identity; otherwise generated and retained before dispatch
      --scope string            Exact scope object or @path; choose roles or permissions, resource roots, optional grant sources and clearance ceiling
      --sign-in-client string   Select the installed application client for business sign-in
      --target string           Read live data or mutate a private sandbox (live, sandbox) (default "live")
      --url string              Use emulation on the deployment at the given URL.
```

## bijection emulation status

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Inspect native liveness, fixed scope and sandbox cleanup progress

Usage:
  bijection emulation status <context> [flags]

Flags:
      --format string   Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help            help for status
      --help-all        Show all commands and options, including administrative controls.
      --help-json       Print command input and output schemas as JSON without executing it.
```


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