nemo-relay-cli 0.7.0

Coding-agent gateway CLI for NeMo Relay observability.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

// SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
// SPDX-License-Identifier: Apache-2.0

use std::process::ExitCode;

use clap::{ArgGroup, Args, Subcommand};

use super::root::AgentArg;
use super::serve::ServerArgs;
use crate::error::CliError;

mod editor;
mod model;
mod wizard;

pub(super) use wizard::run;

#[derive(Debug, Clone, Args)]
#[command(args_conflicts_with_subcommands = true)]
pub(crate) struct ConfigCommand {
    #[command(subcommand)]
    pub(crate) command: Option<ConfigSubcommand>,
    #[arg(value_enum)]
    pub(crate) agent: Option<AgentArg>,
    /// Reset Relay configuration for the selected scope. Persistent Hermes integration state is
    /// managed separately with `nemo-relay uninstall hermes`.
    #[arg(long)]
    pub(crate) reset: bool,
    /// Configuration scope to reset. Defaults to the project configuration.
    #[arg(long, value_enum, requires = "reset")]
    pub(crate) scope: Option<model::ConfigScope>,
}

#[derive(Debug, Clone, Subcommand)]
pub(crate) enum ConfigSubcommand {
    /// Interactively edit gateway, upstream, and operational logging configuration.
    Edit(ConfigEditCommand),
}

#[derive(Debug, Clone, Default, Args)]
#[command(group(
    ArgGroup::new("scope")
        .args(["user", "project", "global"])
        .multiple(false)
))]
pub(crate) struct ConfigEditCommand {
    /// Edit explicit `--config`, otherwise `$XDG_CONFIG_HOME/nemo-relay/config.toml`.
    #[arg(long)]
    pub(crate) user: bool,
    /// Edit the nearest project config at `.nemo-relay/config.toml`.
    #[arg(long)]
    pub(crate) project: bool,
    /// Edit the system config at `/etc/nemo-relay/config.toml`.
    #[arg(long)]
    pub(crate) global: bool,
}

pub(super) async fn execute(
    command: ConfigCommand,
    server: &ServerArgs,
) -> Result<ExitCode, CliError> {
    if let Some(ConfigSubcommand::Edit(edit)) = command.command.as_ref() {
        editor::edit(edit.clone(), server.to_runtime().config)?;
        return Ok(ExitCode::SUCCESS);
    }
    let agent = command.agent.map(Into::into);
    if command.reset {
        model::reset(command.scope.unwrap_or(model::ConfigScope::Project), agent)?;
    } else {
        let overrides = server.to_runtime();
        let explicit_plugin_path = crate::configuration::explicit_plugin_config_path(
            overrides.config.as_ref(),
            overrides.plugin_config_path.as_ref(),
        );
        wizard::run(agent, explicit_plugin_path).await?;
    }
    Ok(ExitCode::SUCCESS)
}