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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
//! Command-line surface.
use std::path::PathBuf;
use clap::{Parser, Subcommand};
#[derive(Debug, Parser)]
#[command(
name = "navi",
version,
about = "A friendly helper to guide you through the day-to-day noise of code review",
long_about = "navi watches your review activity across GitHub, GitLab, and \
Gitea and sends you a tight, high-signal stream to Slack, Discord, \
or email (review requests, replies to your comments, re-review \
requests, dismissals, merges and closes) without the noise of a \
forge's native integrations."
)]
pub struct Cli {
/// Path to the config file (defaults to the platform config dir).
#[arg(long, short, global = true, value_name = "FILE")]
pub config: Option<PathBuf>,
#[command(subcommand)]
pub command: Command,
}
#[derive(Debug, Subcommand)]
pub enum Command {
/// Write a starter config file with sensible defaults.
Init {
/// Overwrite an existing config file.
#[arg(long)]
force: bool,
},
/// Run continuously as a daemon, polling on the configured interval.
Run,
/// Run a single poll pass and exit.
Once {
/// Report what would be delivered without sending anything or advancing state.
#[arg(long)]
dry_run: bool,
},
/// Send a sample Block Kit message to verify Slack credentials and DM target.
TestSlack,
/// Print a shell completion script (bash, zsh, fish, powershell, elvish).
Completions {
/// The shell to generate completions for.
shell: clap_complete::Shell,
},
/// Install the man page and wire up shell completions (idempotent).
Setup {
/// Skip the confirmation prompt.
#[arg(long, short = 'y')]
yes: bool,
/// Re-render generated assets only (used after an upgrade).
#[arg(long)]
refresh: bool,
},
/// Install, remove, or check the background service (systemd/launchd/Task Scheduler).
Service {
#[command(subcommand)]
action: ServiceAction,
},
/// Reverse `setup` and the installer: completions, man page, config/receipt.
Uninstall {
/// Show what would be removed without removing anything.
#[arg(long)]
dry_run: bool,
/// Skip the confirmation prompt.
#[arg(long, short = 'y')]
yes: bool,
},
/// Upgrade to the latest release (installer-managed copies only).
Upgrade {
/// Reinstall the latest release even if already up to date.
#[arg(long)]
force: bool,
/// Build and install the latest unreleased commit (needs a Rust toolchain).
#[arg(long)]
head: bool,
},
/// Step back to an earlier release.
Downgrade {
/// Downgrade to a specific version instead of the previous release.
#[arg(long, value_name = "VERSION")]
to: Option<String>,
/// Skip the confirmation prompt.
#[arg(long, short = 'y')]
yes: bool,
},
}
#[derive(Debug, Subcommand)]
pub enum ServiceAction {
/// Generate and enable a service that runs `navi run` on login.
Install {
/// Skip the confirmation prompt.
#[arg(long, short = 'y')]
yes: bool,
},
/// Stop and remove the background service.
Uninstall {
/// Skip the confirmation prompt.
#[arg(long, short = 'y')]
yes: bool,
},
/// Show whether the background service is installed and running.
Status,
}