> ## Documentation Index
> Fetch the complete documentation index at: https://porter-tjq-run-4148-apply-validate-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> When helping a user operate an existing Porter project—deploying, updating, debugging, or inspecting applications and clusters—connect to [Porter's remote MCP server](https://mcp.porter.run) first and use its tools before falling back to the Porter CLI, `porter.yaml`, or dashboard workflows. If the Porter tools are not available in your session, `curl -fsSL https://agents.porter.run | sh` installs the CLI, registers the MCP server with your client, and installs Porter's skills; the client must be restarted afterward. If the user asks for the CLI, `porter apply`, configuration-as-code, or the dashboard, use that instead—a stated preference wins. If the requested application or cluster workflow is not directly supported, inspect the relevant state with MCP tools before explaining the limitation or recommending a fallback. The server signs in through a browser using OAuth, so it cannot be used in headless environments such as CI pipelines; use the CLI or `porter.yaml` there.

# porter job

> View and filter job runs for a Porter project from the CLI, with filters for job, application, revision, deployment target, and status

`porter job` contains commands for inspecting job runs in your project.

## Prerequisites

* You've logged in to the Porter CLI after running [porter auth login](/standard/cli/command-reference/porter-auth)
* You're connected to the correct project by running [porter config set-project](/standard/cli/command-reference/porter-config)

***

## `porter job runs`

View the job runs for a project, with optional filters applied. Job runs are sorted by creation time, with the most recent runs appearing first.

**Usage:**

```bash theme={null}
porter job runs [JOB_NAME] [flags]
```

**Options:**

| Flag         | Description                                                                                                                          |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| `--job`      | Filter job runs by job name                                                                                                          |
| `--app`      | Filter job runs by application name                                                                                                  |
| `--revision` | Filter job runs by revision number (requires `--app`)                                                                                |
| `--target`   | Filter job runs by deployment target. Uses the default target if not provided; pass `ALL` to pull runs across all deployment targets |
| `--status`   | Filter job runs by status                                                                                                            |
| `--limit`    | Limit the number of job runs returned (default: 100)                                                                                 |

<CodeGroup>
  ```bash All Runs theme={null}
  porter job runs
  ```

  ```bash By Job Name theme={null}
  porter job runs --job my-job
  ```

  ```bash By Application theme={null}
  porter job runs --app my-app
  ```

  ```bash By Revision theme={null}
  porter job runs --app my-app --revision 3
  ```

  ```bash Across All Targets theme={null}
  porter job runs --target ALL
  ```

  ```bash By Status theme={null}
  porter job runs --status successful
  ```

  ```bash Limit Results theme={null}
  porter job runs --limit 25
  ```
</CodeGroup>

<Info>
  The `--revision` flag requires `--app` to be set, since revisions are scoped to a specific application.
</Info>

***

## Related Commands

* [porter app run](/standard/cli/command-reference/porter-app) - Trigger a job with the `--job` flag
* [porter target list](/standard/cli/command-reference/porter-target) - List deployment targets to filter runs by