Match Linux tree file size options: -s for raw bytes, -h for human-readable (1024), --si for SI (1000)

- Change -s to display raw bytes in bracketed format like Linux tree
- Add -h/--human-readable for binary human-readable sizes (KiB, MiB)
- Add --si for SI human-readable sizes (kB, MB)
- Remove -h as help shortcut (--help only) to free it for sizes
- Both -h and --si imply -s

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: yangshun

README.md

@@ -53,7 +53,7 @@ tree [options] [path/to/dir]
 The following options are available:
 
 ```txt
-$ tree -h
+$ tree --help
 
 Usage:
   $ tree <command> [options]
@@ -75,6 +75,10 @@ File options:
   -Q, --quote               Quote filenames in double quotes.
   -p, --permissions         Show file type and permissions.
   -s, --sizes               Print the size of each file in bytes along with the name.
+  -h, --human-readable      Print file sizes in human-readable format (powers
+                            of 1024). Implies -s.
+  --si                      Print file sizes using SI units (powers of 1000).
+                            Implies -s.
   --du                      For each directory report its size as the accumulation
                             of sizes of all its files and sub-directories. Implies -s.
   -D, --date                Show last modification time for each entry.
@@ -100,7 +104,7 @@ Output options:
   -J, --json                Output the tree as a JSON structure.
 
 Misc options:
-  -h, --help                Display this message
+  --help                    Display this message
   --version                 Display version number
 ```
 
@@ -170,6 +174,8 @@ console.log(result);
 | `quote`         | `false`                    | `boolean`  | Quote filenames in double quotes.                                                                                                                                                                                                                                                                     |
 | `permissions`   | `false`                    | `boolean`  | Show file type and permissions (e.g. `[drwxr-xr-x]`).                                                                                                                                                                                                                                                 |
 | `sizes`         | `false`                    | `boolean`  | Print the size of each file in bytes along with the name.                                                                                                                                                                                                                                             |
+| `humanReadable` | `false`                    | `boolean`  | Print file sizes in human-readable format (powers of 1024). Implies `sizes`.                                                                                                                                                                                                                          |
+| `si`            | `false`                    | `boolean`  | Print file sizes using SI units (powers of 1000). Implies `sizes`.                                                                                                                                                                                                                                    |
 | `du`            | `false`                    | `boolean`  | For each directory, report its size as the accumulation of sizes of all its files and sub-directories. Implies `sizes`.                                                                                                                                                                               |
 | `date`          | `false`                    | `boolean`  | Show last modification time for each entry.                                                                                                                                                                                                                                                           |
 | `trailingSlash` | `false`                    | `boolean`  | Append a `/` for directories.                                                                                                                                                                                                                                                                         |

src/__snapshots__/index.test.ts.snap

@@ -416,105 +416,105 @@ exports[`tree > dirsOnly 11`] = `
 exports[`tree > dirsOnly 12`] = `"varied-sizes"`;
 
 exports[`tree > du 1`] = `
-"24B chain
-└── 24B alpha
-    └── 24B alpha
-        └── 24B alpha
-            └── 24B alpha
-                └── 24B alpha
-                    └── 24B alpha
-                        └── 24B alpha
-                            └── 24B alpha
-                                └── 24B alpha.txt"
+"[        24] chain
+└── [        24] alpha
+    └── [        24] alpha
+        └── [        24] alpha
+            └── [        24] alpha
+                └── [        24] alpha
+                    └── [        24] alpha
+                        └── [        24] alpha
+                            └── [        24] alpha
+                                └── [        24] alpha.txt"
 `;
 
 exports[`tree > du 2`] = `
-"29B double-level
-├── 9B alpha.txt
-└── 20B beta
-    └── 20B alpha.txt"
+"[        29] double-level
+├── [         9] alpha.txt
+└── [        20] beta
+    └── [        20] alpha.txt"
 `;
 
-exports[`tree > du 3`] = `"0B empty-dir"`;
+exports[`tree > du 3`] = `"[         0] empty-dir"`;
 
 exports[`tree > du 4`] = `
-"30B hidden-files
-├── 8B another.txt
-└── 8B visible.txt"
+"[        30] hidden-files
+├── [         8] another.txt
+└── [         8] visible.txt"
 `;
 
 exports[`tree > du 5`] = `
-"5B mixed-content
-├── 1B alpha.txt
-├── 1B bravo-dir
-│   └── 1B inner.txt
-├── 1B charlie.txt
-├── 1B delta-dir
-│   └── 1B inner.txt
-└── 1B echo.txt"
+"[         5] mixed-content
+├── [         1] alpha.txt
+├── [         1] bravo-dir
+│   └── [         1] inner.txt
+├── [         1] charlie.txt
+├── [         1] delta-dir
+│   └── [         1] inner.txt
+└── [         1] echo.txt"
 `;
 
 exports[`tree > du 6`] = `
-"68B multi-files
-├── 5B alpha.txt
-├── 17B beta.txt
-└── 46B charlie.txt"
+"[        68] multi-files
+├── [         5] alpha.txt
+├── [        17] beta.txt
+└── [        46] charlie.txt"
 `;
 
 exports[`tree > du 7`] = `
-"127B multi-level
-├── 10B alpha.txt
-├── 48B beta
-│   ├── 27B alpha
-│   │   ├── 16B alpha.txt
-│   │   └── 11B beta
-│   │       └── 11B alpha.txt
-│   ├── 9B beta.txt
-│   └── 12B charlie
-│       └── 12B alpha.txt
-├── 54B charlie
-│   ├── 13B alpha.txt
-│   ├── 18B beta
-│   │   └── 18B alpha.txt
-│   └── 23B charlie.txt
-└── 15B delta.txt"
+"[       127] multi-level
+├── [        10] alpha.txt
+├── [        48] beta
+│   ├── [        27] alpha
+│   │   ├── [        16] alpha.txt
+│   │   └── [        11] beta
+│   │       └── [        11] alpha.txt
+│   ├── [         9] beta.txt
+│   └── [        12] charlie
+│       └── [        12] alpha.txt
+├── [        54] charlie
+│   ├── [        13] alpha.txt
+│   ├── [        18] beta
+│   │   └── [        18] alpha.txt
+│   └── [        23] charlie.txt
+└── [        15] delta.txt"
 `;
 
 exports[`tree > du 8`] = `
-"0B numbered-files
-├── 0B file1.txt
-├── 0B file10.txt
-├── 0B file2.txt
-├── 0B file20.txt
-└── 0B file3.txt"
+"[         0] numbered-files
+├── [         0] file1.txt
+├── [         0] file10.txt
+├── [         0] file2.txt
+├── [         0] file20.txt
+└── [         0] file3.txt"
 `;
 
 exports[`tree > du 9`] = `
-"5B single-file
-└── 5B alpha.txt"
+"[         5] single-file
+└── [         5] alpha.txt"
 `;
 
 exports[`tree > du 10`] = `
-"13B single-level
-├── 13B alpha.txt
-└── 0B beta"
+"[        13] single-level
+├── [        13] alpha.txt
+└── [         0] beta"
 `;
 
 exports[`tree > du 11`] = `
-"4B unicode-names
-├── 1B café.txt
-├── 1B emoji-🎉.txt
-├── 1B über.txt
-└── 1B 日本語
-    └── 1B ファイル.txt"
+"[         4] unicode-names
+├── [         1] café.txt
+├── [         1] emoji-🎉.txt
+├── [         1] über.txt
+└── [         1] 日本語
+    └── [         1] ファイル.txt"
 `;
 
 exports[`tree > du 12`] = `
-"11.1kB varied-sizes
-├── 10kB large.txt
-├── 1kB medium.txt
-├── 100B small.txt
-└── 1B tiny.txt"
+"[     11101] varied-sizes
+├── [     10000] large.txt
+├── [      1000] medium.txt
+├── [       100] small.txt
+└── [         1] tiny.txt"
 `;
 
 exports[`tree > exclude 1`] = `

src/cli.test.ts

@@ -29,8 +29,8 @@ describe('cli', () => {
     expect(exitCode).toBe(0);
   });
 
-  test('displays help with -h', async () => {
-    const { stdout, exitCode } = await run(['-h']);
+  test('displays help with --help', async () => {
+    const { stdout, exitCode } = await run(['--help']);
     expect(stdout).toContain('--all-files');
     expect(stdout).toContain('--exclude');
     expect(exitCode).toBe(0);
@@ -233,11 +233,11 @@ describe('cli', () => {
     ]);
     // Without sizes, just the filename
     expect(withoutSizes).toContain('alpha.txt');
-    expect(withoutSizes).not.toMatch(/\dB/);
-    // With sizes, each line should have a size prefix like "5B" or "4.1kB"
+    expect(withoutSizes).not.toMatch(/\[\s*\d+\]/);
+    // With sizes, each line should have a bracketed size prefix like [     1024]
     const lines = withSizes.split('\n');
     for (const line of lines) {
-      expect(line).toMatch(/\d+(\.\d+)?(B|kB|MB)/);
+      expect(line).toMatch(/\[\s*\d+\]/);
     }
   });
 
@@ -249,7 +249,7 @@ describe('cli', () => {
     // --du implies -s, so sizes should be shown
     const lines = stdout.split('\n');
     for (const line of lines) {
-      expect(line).toMatch(/\dB/);
+      expect(line).toMatch(/\[\s*\d+\]/);
     }
   });
 
@@ -363,7 +363,7 @@ describe('cli', () => {
   });
 
   test('help includes --gitignore option', async () => {
-    const { stdout } = await run(['-h']);
+    const { stdout } = await run(['--help']);
     expect(stdout).toContain('--gitignore');
   });
 

src/cli.ts

@@ -35,6 +35,14 @@ cli
     '-s, --sizes',
     'Print the size of each file in bytes along with the name.',
   )
+  .option(
+    '-h, --human-readable',
+    'Print file sizes in human-readable format (powers of 1024). Implies -s.',
+  )
+  .option(
+    '--si',
+    'Print file sizes using SI units (powers of 1000). Implies -s.',
+  )
   .option(
     '--du',
     'For each directory report its size as the accumulation of sizes of all its files and sub-directories. Implies -s.',
@@ -65,12 +73,18 @@ cli
   // JSON options
   .option('-J, --json', 'Output the tree as a JSON structure.');
 
-cli.help();
+// Register --help without -h shortcut so -h can be reclaimed for other use.
+cli.option('--help', 'Display this message');
 cli.version(version, '--version');
 
 const parsed = cli.parse();
 
-if (parsed.options.help || parsed.options.version) {
+if (parsed.options.help) {
+  cli.outputHelp();
+  process.exit(0);
+}
+
+if (parsed.options.version) {
   process.exit(0);
 }
 
@@ -104,6 +118,10 @@ const options: Options = {
   ...(opts.prune != null && { prune: opts.prune as boolean }),
   ...(opts.quote != null && { quote: opts.quote as boolean }),
   ...(opts.sizes != null && { sizes: opts.sizes as boolean }),
+  ...(opts.humanReadable != null && {
+    humanReadable: opts.humanReadable as boolean,
+  }),
+  ...(opts.si != null && { si: opts.si as boolean }),
   ...(opts.du != null && { du: opts.du as boolean }),
   ...(opts.exclude != null && {
     exclude: (opts.exclude as string)

src/formats/json.test.ts

@@ -11,11 +11,14 @@ const DEFAULT_OPTIONS: RequiredOptions = {
   du: false,
   filesFirst: false,
   fullPath: false,
+  gitignore: true,
+  humanReadable: false,
   noIndent: false,
   permissions: false,
   prune: false,
   quote: false,
   sizes: false,
+  si: false,
   exclude: [],
   maxDepth: Number.POSITIVE_INFINITY,
   reverse: false,

src/formats/text.test.ts

@@ -10,12 +10,15 @@ const DEFAULT_OPTIONS: RequiredOptions = {
   dirsOnly: false,
   du: false,
   filesFirst: false,
+  humanReadable: false,
   fullPath: false,
+  gitignore: true,
   noIndent: false,
   permissions: false,
   prune: false,
   quote: false,
   sizes: false,
+  si: false,
   exclude: [],
   maxDepth: Number.POSITIVE_INFINITY,
   reverse: false,
@@ -145,12 +148,28 @@ describe('formatAsText', () => {
     expect(lines[1]).toBe('└── [-rw-r--r--] a.ts');
   });
 
-  test('sizes shows file size', () => {
+  test('sizes shows file size in raw bytes', () => {
     const node = makeFile('a.ts', { size: 2048 });
     const lines = formatAsText(node, opts({ sizes: true }), '.');
+    expect(lines[0]).toBe('[      2048] a.ts');
+  });
+
+  test('sizes with si shows human-readable size (powers of 1000)', () => {
+    const node = makeFile('a.ts', { size: 2048 });
+    const lines = formatAsText(node, opts({ sizes: true, si: true }), '.');
     expect(lines[0]).toContain('2.05kB');
   });
 
+  test('sizes with humanReadable shows binary size (powers of 1024)', () => {
+    const node = makeFile('a.ts', { size: 2048 });
+    const lines = formatAsText(
+      node,
+      opts({ sizes: true, humanReadable: true }),
+      '.',
+    );
+    expect(lines[0]).toContain('2KiB');
+  });
+
   test('fullPath shows relative path', () => {
     const node = makeDir('src', [makeFile('a.ts', { path: 'src/a.ts' })]);
     const lines = formatAsText(node, opts({ fullPath: true }), 'src');

src/formats/text.ts

@@ -49,8 +49,13 @@ export function formatAsText(
   }
 
   if (options.sizes) {
-    const prettifiedFilesize = prettyBytes(node.size);
-    line.push(prettifiedFilesize.replace(' ', ''));
+    if (options.si) {
+      line.push(prettyBytes(node.size).replace(' ', ''));
+    } else if (options.humanReadable) {
+      line.push(prettyBytes(node.size, { binary: true }).replace(' ', ''));
+    } else {
+      line.push(`[${String(node.size).padStart(10)}]`);
+    }
     line.push(' ');
   }