# Using the console

The console is served by Shipyard itself at the address in `listen` — `http://127.0.0.1:8080` by default.

## Connect

The pill in the top bar shows your access:

| Indicator | Meaning |
|---|---|
| **Read-only** | No token entered. You can browse, but not queue, cancel or retry. |
| **Connected** | Token accepted. All actions are available. |
| **Token required** | The server protects reads too. Enter the token to see anything. |
| **Server unreachable** | Shipyard is not answering. |

Click the pill and paste the value of the variable named by `runtime.api_token_env`. The token stays in the tab's memory only; reloading the page forgets it.

## Runs

![Run list with a pipeline open in the detail panel and its live log](/img/screens/runs-light.webp)

The **Runs** view lists the latest runs, newest first, and refreshes every five seconds.

- Filter by status — **All**, **Active**, **Succeeded**, **Failed**, **Cancelled** — or by project.
- **Load older runs** pages back through history.
- Click a run to open its panel: project, type, attempts, timings, the error if it failed, and the log.

### Queue a run

![New run dialog with project, type, pipeline and input](/img/screens/new-run.webp)

**New run** opens a form. Pick a project and a type:

| Type | What it does | Needs |
|---|---|---|
| **Diagnostic** | Checks that the project is configured and enabled. | Nothing else |
| **Pipeline** | Runs a [pipeline](/pipelines/) from your configuration. | A pipeline name; optional input |
| **AI text** | Sends one prompt to the model routed for the role you pick. | A role and a prompt |

AI runs call your provider and can cost money.

### Follow the log

The log tails live while the run is active; untick **Follow** to scroll freely. Runs that were retried after a crash have several attempts — switch between them with **Attempt**.

### Cancel and retry

- **Cancel run** stops a queued run at once and asks a running one to stop at the next safe point.
- **Retry as new run** queues a failed or cancelled run again with the same input. The original stays in the history.

## Projects

![Projects view with status, issue label, release interval, content review and where each project runs](/img/screens/projects.webp)

**Projects** lists the repositories in your configuration with their issue label, release interval, content review and where they run — this Shipyard or ships with matching labels.

**Add project** opens a form: ID, repository, issue label, release interval, optional ship labels and content review. Shipyard validates it, appends it to the configuration file — comments and layout are kept — and starts accepting runs for it immediately, no restart needed. When the configuration is loaded from a URL the view is read-only.

## Pipelines

**Pipelines** shows every pipeline step by step; **Run pipeline** opens the form with that pipeline selected. Pipelines are defined in the configuration file.

## Docks

![Docks view listing ships](/img/screens/docks.webp)

**Docks** lists the ships joined to this Shipyard — online, offline or revoked — with their labels, platform, version and the run they are executing. **Add ship** creates a one-time join command; **Revoke** cuts a ship off. The run panel shows where each run ran. See [Ships and docks](/ships/).

## Language

The console is in English. Choose **Polski** in the top bar to switch; the choice is remembered in this browser. Add `?lang=pl` to a link to open it in Polish.