> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/relay/llms.txt.
> For full documentation content, see https://docs.nvidia.com/nemo/relay/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/relay/_mcp/server.

# About

Use this section when you want the `nemo-relay` binary to observe local coding
agent sessions through hooks, a passthrough LLM gateway, and NeMo Relay
observability exporters.

The NeMo Relay CLI is installed by the `nemo-relay-cli` Cargo package. It can run
supported coding agents through a managed local gateway, forward agent hook
payloads into NeMo Relay lifecycle events, route OpenAI-compatible or
Anthropic-compatible model traffic through the gateway, and diagnose local
configuration.

## Start Here When

Use these guides when you need to:

* Observe Claude Code, Codex, Cursor, or Hermes Agent sessions locally.
* Configure coding-agent hooks for NeMo Relay lifecycle events.
* Route model-provider traffic through the local NeMo Relay gateway.
* Export local sessions to Agent Trajectory Interchange Format (ATIF), Agent
  Trajectory Observability Format (ATOF) JSONL, OpenTelemetry, or
  OpenInference.
* Diagnose hook loading, gateway routing, and exporter output.

If you are instrumenting an application or framework directly, use
[Instrument Applications](/instrument-applications/about) or
[Integrate into Frameworks](/integrate-into-frameworks/about) instead.

## Agent Harness Support

NeMo Relay CLI support is experimental and observability-focused.

| Agent        | Observability | Security | Optimization | Notes                                                                          |
| ------------ | ------------- | -------- | ------------ | ------------------------------------------------------------------------------ |
| Claude Code  | ✅ Yes         | ❌ No     | ❌ No         | Observability only; no known issues.                                           |
| Codex        | ✅ Yes         | ❌ No     | ❌ No         | Observability only; some hooks needed for full feature coverage are missing.   |
| Hermes Agent | ✅ Yes         | ❌ No     | ❌ No         | Observability only; no known issues.                                           |
| Cursor       | ✅ Yes         | ❌ No     | ❌ No         | Observability only; missing hooks under `cursor-agent` limit feature coverage. |

## Guides

Use these guide links to move from CLI setup into agent-specific instructions.

* [Basic Usage](/nemo-relay-cli/basic-usage) explains gateway routes, transparent runs,
  shared configuration, hook forwarding, and runtime mapping.
* [Claude Code](/nemo-relay-cli/claude-code) covers transparent Claude Code
  runs, Anthropic gateway routing, ATIF verification, and unsupported Claude
  application modes.
* [Codex](/nemo-relay-cli/codex) covers transparent Codex CLI runs, local
  GUI/app caveats, model provider routing, and remote-task limits.
* [Cursor](/nemo-relay-cli/cursor) covers transparent Cursor runs, temporary
  hook patching, GUI and CLI smoke tests, and gateway routing limits.
* [Hermes Agent](/nemo-relay-cli/hermes) covers Hermes shell hook installation,
  dynamic gateway URL handling, session-finalize behavior, and hook consent
  caveats.

Start with [Basic Usage](/nemo-relay-cli/basic-usage), then use the guide for the coding
agent that you want to observe.