Context CLI

graphsignal-context

CLI for logging in and fetching Graphsignal signal context.

Install:

pip install graphsignal-context

Or install as an isolated CLI tool with uv:

uv tool install graphsignal-context

graphsignal-context login

Store your Graphsignal API key in ~/.graphsignal/config.yml.

graphsignal-context login

You will be prompted for your API key.

graphsignal-context signals

Fetch signal context for a time range.

graphsignal-context signals --start 2026-03-10T00:00:00Z --end 2026-03-12T00:00:00Z

Optional --tags filter:

graphsignal-context signals \
  --start 2026-03-10T00:00:00Z \
  --end 2026-03-12T00:00:00Z \
  --tags "env:prod;service:inference"

Options:

  • --start (required): Start of time range in ISO 8601 format (for example, 2026-03-10T00:00:00Z).
  • --end (required): End of time range in ISO 8601 format.
  • --tags (optional): Semicolon-separated key:value pairs for exact tag filtering.

Behavior:

  • Requires a saved API key (graphsignal-context login).
  • Converts --start and --end into nanosecond timestamps.
  • Calls GET /api/v1/context/signals/ on https://api.graphsignal.com.
  • Prints the returned context payload to stdout.

graphsignal-context guide

Fetch information about signals.

graphsignal-context guide

Behavior:

  • Requires a saved API key (graphsignal-context login).
  • Calls GET /api/v1/context/guide/ on https://api.graphsignal.com.
  • Prints the returned text content to stdout.

Common errors:

  • Not logged in: run graphsignal-context login.
  • Invalid datetime format for --start or --end.
  • --start must be before --end.
  • API request errors (for example, invalid API key).