CLI

Use Hermes through the command line with clear first commands and practical next actions.

CLI is the direct path for local daily usage. This page covers when to use it, what to run first, and when to continue to gateway or skills.

Time to complete

~10-15 minutes

Commands

hermes

Primary command for direct local interaction.

hermes setup

Initialize or repair setup state for CLI usage.

hermes update

Update Hermes to the latest supported release.

hermes doctor

Diagnose environment and configuration issues quickly.

Troubleshooting hint

If CLI behavior is inconsistent, run `hermes doctor` first, then retry after `hermes setup` and environment verification.

Steps

  1. 1. Use `hermes` as your primary command-line entry point.

  2. 2. Run `hermes setup` when you initialize or reconfigure local usage.

  3. 3. Run `hermes update` on a controlled cadence to keep versions current.

  4. 4. Run `hermes doctor` whenever behavior looks inconsistent.

  5. 5. Move to gateway for messaging integrations, or to skills for reusable workflows.

Prerequisites

  • Hermes installation and basic setup are complete.
  • You can run Hermes commands in your target terminal environment.

Notes

  • Use CLI first when you want predictable local control and debugging.
  • Continue to gateway when your target interaction channel is messaging apps.
  • Continue to skills when you need reusable task patterns for team workflows.

Next step

Related Guides

Gateway

Add messaging-platform routing after CLI basics are stable.

Set Up Gateway

Skills

Model repeatable usage patterns as reusable skills.

Open Skills

Memory

Add persistent context to long-running CLI workflows.

Open Memory