Back to Commands
Operationshermes status

hermes status Command — Complete Reference & Examples

Complete reference for hermes status: display the status of Hermes Agent components — environment, API keys, auth providers, and more.

July 27, 2026

Overview

hermes status displays the status of Hermes Agent components: the runtime environment, configured API keys, auth providers, and related checks. It is the go-to command for a quick, at-a-glance overview of your installation.

hermes status

Options

Option Description
--all Show all details (redacted for sharing)
--deep Run deep checks (may take longer)

What It Reports

Section Content
Environment Project directory, Python version, .env file presence, model and provider
API Keys Per-provider status: set or not set
Auth Providers Login state for each auth provider, with a fix command when not logged in

Common Scenarios

Quick Overview

hermes status
# At-a-glance health check of the environment, keys, and auth state

Sharing a Status Report

hermes status --all
# Show every detail — output is redacted for safe sharing

Deep Diagnostics

hermes status --deep
# Run deeper checks; may take longer than a plain status

Verifying Setup After Configuration

hermes status
# Confirm your API keys and auth providers show as configured

Tips

  • Output is redacted by default so it is safe to share; use --all to reveal everything
  • --deep runs additional checks and can take longer
  • When something looks wrong, the output often points to the next command to run
  • Combine with hermes doctor for deeper configuration diagnostics

Explore All Commands

Browse the full command reference with search and category filters.

Back to Commands