prj-cli 1.1.0

A CLI tool for managing projects on your local machine
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

use std::path::PathBuf;

use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(name = "prj", about = "Local project manager", version)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Option<Command>,
}

#[derive(Subcommand)]
pub enum Command {
    /// Register a project (defaults to current directory)
    Add {
        /// Path to the project directory
        path: Option<PathBuf>,
        /// Display name for the project
        #[arg(long)]
        name: Option<String>,
    },

    /// Recursively discover and register projects
    Scan {
        /// Directory to scan
        dir: PathBuf,
        /// Maximum directory depth to scan
        #[arg(long, default_value = "3")]
        depth: usize,
    },

    /// Git clone and auto-register
    New {
        /// Git clone arguments (e.g. `https://github.com/user/repo`)
        #[arg(long = "git")]
        git: String,
    },

    /// Unregister a project (no file deletion)
    Remove {
        /// Project name to remove
        project: String,
    },

    /// List registered projects
    List {
        /// Plain text output (no TUI)
        #[arg(long)]
        plain: bool,
        /// Filter by tag
        #[arg(long)]
        tag: Option<String>,
    },

    /// Show project statistics
    Stats {
        /// Specific project name (omit for overview)
        project: Option<String>,
        /// Output as JSON
        #[arg(long)]
        json: bool,
    },

    /// Output shell init script
    Init {
        /// Shell type (zsh, bash, powershell)
        shell: String,
        /// Name of the shell function to create
        #[arg(long, default_value = "prjp")]
        cmd: String,
    },

    /// Add tags to a project
    Tag {
        /// Project name
        project: String,
        /// Tags to add
        tags: Vec<String>,
    },

    /// Remove tags from a project
    Untag {
        /// Project name
        project: String,
        /// Tags to remove
        tags: Vec<String>,
    },

    /// Quick git status dashboard across all projects
    Status {
        /// Output as JSON
        #[arg(long)]
        json: bool,
    },

    /// Remove projects whose paths no longer exist
    Gc {
        /// Only show what would be removed
        #[arg(long)]
        dry_run: bool,
    },

    /// Delete artifact directories (target, node_modules, etc.)
    Clean {
        /// Project name (omit with --all for all projects)
        project: Option<String>,
        /// Clean all projects
        #[arg(long)]
        all: bool,
        /// Only show what would be deleted
        #[arg(long)]
        dry_run: bool,
    },

    /// Run a command in project directory(s)
    Run {
        /// Command to execute
        cmd: String,
        /// Target specific project
        #[arg(long)]
        project: Option<String>,
        /// Filter by tag
        #[arg(long)]
        tag: Option<String>,
        /// Run in all projects
        #[arg(long)]
        all: bool,
    },

    /// Export project manifest
    Export {
        /// Output file (defaults to stdout)
        #[arg(long)]
        output: Option<PathBuf>,
        /// Base directory for relative paths
        #[arg(long)]
        base_dir: Option<PathBuf>,
    },

    /// Import and clone projects from a manifest
    Import {
        /// Manifest file to import
        file: PathBuf,
        /// Base directory for cloning
        #[arg(long)]
        base_dir: Option<PathBuf>,
    },
}