# x-cmd

**Repository Path**: leejason/x-cmd

## Basic Information

- **Project Name**: x-cmd
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# x

A unified CLI toolkit for filesystem operations on Linux/macOS. Replaces the
fragmented `fd` / `ripgrep` / `dust` / `tree` / `sd` / `rdfind` / `rsync` toolchain
with a single fast, composable binary.

## Status

**M1 — `x find` shipped.** Walker, matcher, and JSON/CSV/long/path output
are implemented. Other subcommands are still stubs. See
[docs/design.md](docs/design.md) for the full design.

## Build

```sh
cargo build --release
./target/release/x --help
```

## `x find`

```
x find [PATH]... [-e EXT]... [-t f|d|l|p] [-s +1M] [-m 7d] [-n GLOB]
            [--hidden] [--no-ignore] [--max-depth N] [-j N]
            [--format path|long|json|csv] [-0]
```

Examples:

```sh
# All .rs files
x find -e rs

# Big files modified in the last week
x find -s +1M -m -7d

# Markdown files whose name contains "design"
x find -n "*design*.md" -t f

# Pipe to xargs safely
x find -e log -0 -t f | xargs -0 rm
```

## Subcommands

| Command | Status | Description |
|---------|--------|-------------|
| `x find` | done | Fast file/directory finder |
| `x grep` | TODO | Content search |
| `x move` | TODO | Batch rename/move with templates |
| `x size` | TODO | Disk usage analyzer |
| `x tree` | TODO | Tree visualization |
| `x dedup` | TODO | Find duplicates |
| `x sync` | TODO | One-way directory sync |
| `x meta` | TODO | View/modify metadata |
| `x index` | V2 | Optional background indexer |

## License

MIT OR Apache-2.0