Utility Commands

Small commands for orientation and diagnostics.

Commands

Command Description
stategraph info Show current user, tenants, server version, and suggested next steps
stategraph version client Print the client version
stategraph version server Print the server version

stategraph info

Show orientation info in a single call: the current user, client and server versions, and the tenants you belong to. In table or simple format it also prints suggested next steps — useful for new users and AI agents getting their bearings.

stategraph info

Options

Option Required Description
--format No Output format: table (default), json, or simple

Example

stategraph info

key       value
--------  ----------------------------------------------
User      Jane Smith (jane@example.com) [admin]
Server    2.3.2
Client    2.3.2
Tenants   1
  Tenant  production (550e8400-e29b-41d4-a716-446655440000)

--- What you can do next ---
  stategraph sql schema                  # Discover queryable tables
  stategraph query "SELECT * FROM resources"  # Browse your infrastructure
  stategraph states list --tenant ID     # List Terraform states
  stategraph gaps --tenant ID --provider aws  # Find unmanaged resources
  stategraph blast-radius ADDR --state ID     # Check impact before changes

For scripting, use --format json to get the same data as a single JSON object.

stategraph version

Print version information for the client and the server. version client is fully offline; version server queries the configured server.

stategraph version client
stategraph version server

Example

stategraph version client
# 2.3.2

stategraph version server
# 2.3.2

stategraph --version is equivalent to version client. Use these in CI to assert client/server compatibility before running operations.

Next Steps