Class Add

atomic-cli/src/commands/add.rs:125–185

/// - `--no-recursive`: Don't recursively add directory contents
#[derive(Parser, Debug)]
pub struct Add {
    /// Files or directories to add to tracking.
    ///
    /// Paths can be relative or absolute. Directories will be added
    /// recursively by default.
    #[arg(value_name = "FILES", required_unless_present = "all")]
    pub files: Vec<String>,

    /// Add all untracked files in the repository.
    ///
    /// This is equivalent to running `atomic status` to find untracked files
    /// and then adding them all. Use with caution in large repositories.
    #[arg(short = 'A', long = "all", conflicts_with = "files")]
    pub all: bool,

    /// Dry run - show what would be added without doing it.
    ///
    /// When enabled, displays the files that would be added but doesn't
    /// actually modify the repository. Useful for previewing changes.
    #[arg(short = 'n', long = "dry-run")]
    pub dry_run: bool,

    /// Force add ignored files.
    ///
    /// By default, files matching ignore patterns are skipped. Use this
    /// flag to add them anyway.
    #[arg(short = 'f', long = "force")]
    pub force: bool,

    /// Recursively add directory contents.
    ///
    /// When adding a directory, also add all files within it.
    /// This is the default behavior.
    #[arg(short = 'r', long = "recursive", default_value = "true")]
    pub recursive: bool,

    /// Don't recursively add directory contents.
    ///
    /// When adding a directory, only add the directory itself,
    /// not its contents.
    #[arg(long = "no-recursive", conflicts_with = "recursive")]
    pub no_recursive: bool,

    /// Track empty directories explicitly.
    ///
    /// By default, Atomic only tracks files (directories are created implicitly
    /// when needed). Use this flag to explicitly track empty directories.
    ///
    /// Unlike Git (which requires `.keep` files), Atomic supports tracking
    /// empty directories as first-class citizens in the repository graph.
    ///
    /// # Example
    ///
    /// ```text
    /// $ atomic add --directory src/empty_module/
    /// Adding directory: src/empty_module/
    /// ✓ Added 1 directory
    /// ```