keep-running 0.1.0

Human-friendly terminal session manager with dtach-style detach
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use clap::{CommandFactory, Parser, Subcommand};
use clap_complete::{generate, Shell};

const KEYBINDINGS_HELP: &str = "\
Keybindings (inside an attached session):
  Ctrl+a d        Detach from the session (leave it running)
  Ctrl+a k        Kill the session
  Ctrl+a Ctrl+a   Send a literal Ctrl+a to the program";

const TOP_LEVEL_HELP: &str = "\
Shortcuts:
  keep-running                  list running sessions
  keep-running <name>           attach to a session (prefix match works)

Keybindings (inside an attached session):
  Ctrl+a d        Detach from the session (leave it running)
  Ctrl+a k        Kill the session
  Ctrl+a Ctrl+a   Send a literal Ctrl+a to the program";

#[derive(Parser)]
#[command(name = "keep-running")]
#[command(about = "Human-friendly terminal session manager with dtach-style detach")]
#[command(after_help = TOP_LEVEL_HELP)]
#[command(after_long_help = TOP_LEVEL_HELP)]
#[command(version)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Option<Commands>,

    /// Session name for shortcut attach (e.g., `keep-running fuzzy-penguin`)
    #[arg(value_name = "SESSION")]
    pub session: Option<String>,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Start a new session with the given command
    #[command(trailing_var_arg = true)]
    #[command(after_help = KEYBINDINGS_HELP)]
    #[command(after_long_help = KEYBINDINGS_HELP)]
    Run {
        /// Session name (auto-generated if not specified)
        #[arg(short, long)]
        name: Option<String>,

        /// Command to run
        #[arg(required = true)]
        command: Vec<String>,
    },

    /// Start a new session with your default shell
    Shell {
        /// Session name (auto-generated if not specified)
        #[arg(short, long)]
        name: Option<String>,
    },

    /// Attach to an existing session
    Attach {
        /// Session name (or prefix)
        session: String,
    },

    /// List all running sessions
    #[command(alias = "ls")]
    List,

    /// Kill a running session
    Kill {
        /// Session name (or prefix)
        session: String,
    },

    /// Start a session daemon without attaching (for scripts/testing)
    Start {
        /// Session name (auto-generated if not specified)
        #[arg(short, long)]
        name: Option<String>,

        /// Command to run
        #[arg(required = true, trailing_var_arg = true)]
        command: Vec<String>,
    },

    /// Generate shell completions
    Completions {
        /// Shell to generate completions for
        #[arg(value_enum)]
        shell: Shell,
    },
}

pub fn parse() -> Cli {
    Cli::parse()
}

pub fn print_completions(shell: Shell) {
    let mut cmd = Cli::command();
    generate(shell, &mut cmd, "keep-running", &mut std::io::stdout());
}