pks agentics runner status

When a runner is handed off to a registered SSH target, it runs inside a tmux session named after the owner/project. runner status captures that session's pane and tells you whether the runner is alive, what it printed last, and whether the target is missing the Claude credentials volume a headless devcontainer spawn needs.

1. Prerequisites

• A completed handoff. The offer appears during a degraded runner start on an interactive console. The local registration then records the SSH target label.
• SSH reachability to the target, registered with pks ssh register or created by pks vm init.
• tmux on the remote machine. This command drives tmux capture-pane over SSH exclusively — never systemd.

2. Check a target

pks agentics runner status hetzner

The output reports whether the session is present (it has output) or has exited, followed by the last 10 lines of the pane. For the whole buffer, use runner logs.

Omitting TARGET auto-selects the only registered SSH target, or opens an interactive picker when more than one is registered — so non-interactive callers must always pass it.

3. Disambiguate several projects

If more than one project was handed off to the same target, the command lists the ambiguous matches and exits 1. Name the project:

pks agentics runner status hetzner --project myorg/myproject

4. Read the credentials warning

The command also checks whether the target's Claude credentials Docker volume for this owner/project appears to be missing. A missing volume means a headless devcontainer spawn there stalls on an interactive OAuth login that nobody can complete. Fix it with runner claude-login.

5. Verify

A healthy target prints a present session, recent runner output such as poll cycles, and no credentials-volume warning.

Options

Argument

Troubleshooting

• "No project has been handed off to <target>". No local runner registration records this target's label or host. Re-run the handoff from a degraded runner start.
• The command lists several projects and exits 1. Pass --project owner/project.
• The session reports as exited. The remote runner stopped. Re-run the handoff, or start the runner on the remote machine directly.
• A credentials-volume warning keeps appearing. Run runner claude-login against the same target and project, so the volume names match.

See also

• Print a handed-off runner's full output — the untruncated pane buffer
• Stop a handed-off runner — kill the remote tmux session
• Log in to Claude on an SSH target — clear the credentials warning
• pks agentics CLI reference — every flag and environment variable