htb-cli 0.1.0

Hack The Box CLI
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

pub mod auth;
pub mod challenges;
pub mod machines;
pub mod search;
pub mod seasons;
pub mod sherlocks;
pub mod user;
pub mod vpn;

use std::path::PathBuf;

use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(
    name = "htb",
    version,
    about = "Hack The Box CLI",
    long_about = "Hack The Box CLI - interact with the HTB platform from your terminal.\n\nQuery machines, challenges, Sherlocks, and seasons. Spawn instances, submit flags, manage VPN connections.",
    after_help = "Examples:\n  htb auth login                              Save your API token\n  htb machines list --os linux --difficulty easy   Filter machines\n  htb machines start Bedside                  Spawn a machine\n  htb challenges list --category Web          Browse web challenges\n  htb challenges submit 1018 'HTB{flag}'      Submit a challenge flag\n  htb vpn list                                Show VPN servers\n  htb user me                                 View your profile\n  htb search nmap                             Search across all content"
)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Command,

    #[arg(long, global = true, help = "Output as JSON")]
    pub json: bool,

    #[arg(long, global = true, help = "Disable colored output")]
    pub no_color: bool,

    #[arg(short, long, global = true, help = "Enable debug logging")]
    pub verbose: bool,

    #[arg(long, global = true, help = "Override config file path")]
    pub config: Option<PathBuf>,
}

#[derive(Subcommand)]
pub enum Command {
    /// Manage authentication
    Auth {
        #[command(subcommand)]
        command: auth::AuthCommand,
    },
    /// Browse and interact with machines
    Machines {
        #[command(subcommand)]
        command: machines::MachineCommand,
    },
    /// Browse and interact with challenges
    Challenges {
        #[command(subcommand)]
        command: challenges::ChallengeCommand,
    },
    /// View seasons and rankings
    Seasons {
        #[command(subcommand)]
        command: seasons::SeasonCommand,
    },
    /// Browse and interact with Sherlocks
    Sherlocks {
        #[command(subcommand)]
        command: sherlocks::SherlockCommand,
    },
    /// Manage VPN connections
    Vpn {
        #[command(subcommand)]
        command: vpn::VpnCommand,
    },
    /// View user profiles
    User {
        #[command(subcommand)]
        command: user::UserCommand,
    },
    /// Search across all content
    Search {
        /// Search query
        query: String,
    },
}