Skip to content

nkapp logs

Stream or snapshot logs from one or more project services. Logs are color-coded per service for easy scanning.

bash
nkapp logs [services...] [options]

By default, nkapp logs shows a snapshot of the last 100 log lines and exits. Use -f (or --follow) to stream logs in real-time.

Arguments

ArgumentTypeDescription
servicesstring[]Optional service names to filter. If omitted, logs from all services are shown.

Options

FlagTypeDefaultDescription
-f, --followbooleanfalseStream logs in real-time
-e, --env <env>stringlocalTarget environment
-t, --tail <n>number100Number of historical lines to show

Features

Multi-Service Multiplexing

When streaming from multiple services, each service gets a unique color prefix:

[web]    Listening on port 3000
[api]    Connected to database
[worker] Processing job #1234

Remote Streaming

For remote environments, logs are streamed through the active provider's SSH tunnel — no need to manually SSH into the server.


Examples

bash
# Show snapshot of all service logs (default)
nkapp logs

# Show last 50 lines from a specific service without following
nkapp logs api --tail 50

# Stream logs in real-time from a specific service
nkapp logs api -f

# Stream staging logs
nkapp logs -e stage -f