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

# ankra application

> Manage applications

## ankra application

Connect application source repositories to Ankra for analysis, packaging, and deployment.

## ankra application add

Add an application by reading a local Git checkout.

The command detects the GitHub repository from the selected remote, uses the
remote's default branch when available, and falls back to the current branch.
It selects an available GitHub credential automatically when the choice is
unambiguous.

```bash theme={null}
ankra application add <path> [flags]
```

**Examples**

```bash theme={null}
ankra application add .
  ankra application add ./services/payments --name payments
  ankra application add . --credential github-acme --branch main
```

**Flags**

| Flag             | Default  | Description                                               |
| ---------------- | -------- | --------------------------------------------------------- |
| `--branch`       |          | Repository branch (auto-detected when omitted)            |
| `--credential`   |          | GitHub credential name or ID (auto-detected when omitted) |
| `--name`         |          | Application name (defaults to the repository name)        |
| `-o`, `--output` |          | Output format: json or yaml (default: human-readable)     |
| `--remote`       | `origin` | Git remote used to identify the GitHub repository         |

## ankra application branch-files

List the tracked files on the setup branch

```bash theme={null}
ankra application branch-files <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application branches

List the application repository branches

```bash theme={null}
ankra application branches <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application chart-versions

List an application's published chart versions

```bash theme={null}
ankra application chart-versions <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application code-security

Show source code security findings

```bash theme={null}
ankra application code-security <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application container-security

Show container image vulnerability findings

```bash theme={null}
ankra application container-security <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application delete

Delete an application

```bash theme={null}
ankra application delete <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `--yes`          | `false` | Skip the confirmation prompt                          |

## ankra application demo

Deploy, inspect, and stop short-lived demo workspaces for a branch or pull request of an application.

## ankra application demo build

Check whether a branch has a demo-ready container image

```bash theme={null}
ankra application demo build <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--branch`       |         | Repository branch to inspect (required)               |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application demo deploy

Deploy a short-lived demo workspace for a branch or pull request.

All flags are optional; only the flags you set are sent, so the backend
applies its own defaults for the rest.

```bash theme={null}
ankra application demo deploy <application-id> [flags]
```

**Examples**

```bash theme={null}
ankra application demo deploy <app-id> --branch feature/login
  ankra application demo deploy <app-id> --pr-number 42 --ttl-hours 8
```

**Flags**

| Flag               | Default | Description                                           |
| ------------------ | ------- | ----------------------------------------------------- |
| `--branch`         |         | Repository branch to deploy                           |
| `--container-port` | `0`     | Container port to expose                              |
| `--image-tag`      |         | Explicit container image tag to deploy                |
| `-o`, `--output`   |         | Output format: json or yaml (default: human-readable) |
| `--pr-number`      | `0`     | Pull request number to deploy                         |
| `--ttl-hours`      | `0`     | Lifetime of the demo workspace in hours               |

## ankra application demo list

List the application's active demo workspaces

```bash theme={null}
ankra application demo list <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application demo stop

Stop and tear down a demo workspace

```bash theme={null}
ankra application demo stop <application-id> <workspace-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application deploy

Deploy a packaged application to a target cluster.

The cluster is identified by ID. Use --set key=value (repeatable) to pass
deploy inputs declared by the application's chart.

```bash theme={null}
ankra application deploy <application-id> [flags]
```

**Examples**

```bash theme={null}
ankra application deploy <app-id> --cluster <cluster-id>
  ankra application deploy <app-id> --cluster <cluster-id> --namespace prod --set replicas=3
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--cluster`      |         | Target cluster ID (required)                          |
| `--mode`         |         | Deploy mode: quick or high\_availability              |
| `--namespace`    |         | Target namespace (defaults to the platform default)   |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `--set`          | `[]`    | Deploy input as key=value (repeatable)                |

## ankra application deployments

List an application's cluster deployments

```bash theme={null}
ankra application deployments <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application files

Commit changes to the application's setup pull request.

Each --file maps a repository path to a local file whose contents are
uploaded. Use --delete to remove a tracked path.

```bash theme={null}
ankra application files <application-id> [flags]
```

**Examples**

```bash theme={null}
ankra application files <app-id> --file Dockerfile=./Dockerfile --message "Update image"
  ankra application files <app-id> --delete .ankra/manifests/app.yaml
```

**Flags**

| Flag             | Default | Description                                                            |
| ---------------- | ------- | ---------------------------------------------------------------------- |
| `--delete`       | `[]`    | Repository path to delete (repeatable)                                 |
| `--file`         | `[]`    | Repository path mapped to a local file as path=local-file (repeatable) |
| `--message`      |         | Commit message                                                         |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable)                  |

## ankra application get

Show an application's detail

```bash theme={null}
ankra application get <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application installations

List an application's installation intents

```bash theme={null}
ankra application installations <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application jobs

List an application's platform jobs

```bash theme={null}
ankra application jobs <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `--page`         | `0`     | Page number (1-based)                                 |
| `--page-size`    | `0`     | Page size (1-100)                                     |

## ankra application list

List applications

```bash theme={null}
ankra application list [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `--page`         | `0`     | Page number (1-based)                                 |
| `--page-size`    | `0`     | Page size (1-100)                                     |
| `--search`       |         | Filter applications by name                           |

## ankra application make-public

Make the GHCR image and chart packages public

```bash theme={null}
ankra application make-public <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `--yes`          | `false` | Skip the confirmation prompt                          |

## ankra application package-visibility

Show the GHCR image and chart package visibility

```bash theme={null}
ankra application package-visibility <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application platform

Detect platform operators already present on a target cluster

```bash theme={null}
ankra application platform <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--cluster`      |         | Target cluster ID (required)                          |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application publish-readiness

Report whether the repository can publish to GHCR

```bash theme={null}
ankra application publish-readiness <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application pull-request-reviews

Show the AI reviews of the application's pull requests

```bash theme={null}
ankra application pull-request-reviews <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--limit`        | `0`     | Maximum number of reviews (1-20)                      |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application reconcile

Request an application refresh

```bash theme={null}
ankra application reconcile <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application rerun-workflow

Re-trigger a failed workflow run

```bash theme={null}
ankra application rerun-workflow <application-id> <run-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application retry

Re-trigger a failed application's setup

```bash theme={null}
ankra application retry <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application set-package-visibility

Set the GHCR image or chart package visibility

```bash theme={null}
ankra application set-package-visibility <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--kind`         |         | Package kind: image or chart (required)               |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `--visibility`   |         | Visibility: public or private (required)              |

## ankra application upgrade-workflow

Add security scanning steps to the build workflow

```bash theme={null}
ankra application upgrade-workflow <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application workflow-run-jobs

List the jobs of a workflow run

```bash theme={null}
ankra application workflow-run-jobs <application-id> <run-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra application workflow-runs

List the application's GitHub Actions workflow runs

```bash theme={null}
ankra application workflow-runs <application-id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `--page`         | `0`     | Page number (1-based)                                 |
| `--page-size`    | `0`     | Page size (1-50)                                      |
| `--status`       |         | Filter by GitHub run status                           |