fix: resolve Windows compatibility issues across CLI

- Remove unsupported --force-local tar flag for Windows bsdtar
- Replace process.env.HOME with os.homedir() in info and doctor commands
- Use 'python' instead of 'python3' on Windows for preview fallback
- Bump version to 1.4.2

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: DevRohit06

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litodocs/cli",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Beautiful documentation sites from Markdown. Fast, simple, and open-source.",
   "type": "module",
   "bin": {

src/commands/doctor.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
 import { resolve, join, extname } from 'path';
+import { homedir } from 'os';
 import { intro, outro, log, spinner } from '@clack/prompts';
 import pc from 'picocolors';
 import { validateConfig } from '../core/config-validator.js';
@@ -257,7 +258,7 @@ async function checkCommonIssues(inputPath) {
 }
 
 async function checkTemplateCache() {
-  const cacheDir = join(process.env.HOME || '~', '.lito', 'templates');
+  const cacheDir = join(homedir(), '.lito', 'templates');
 
   if (!existsSync(cacheDir)) {
     return {

src/commands/info.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
 import { resolve, join, extname } from 'path';
+import { homedir } from 'os';
 import { intro, outro, log } from '@clack/prompts';
 import pc from 'picocolors';
 import { TEMPLATE_REGISTRY } from '../core/template-registry.js';
@@ -137,7 +138,7 @@ export async function infoCommand(options) {
     log.message(`  ${pc.cyan('Node.js:')} ${process.version}`);
     log.message(`  ${pc.cyan('Platform:')} ${process.platform}`);
 
-    const cacheDir = join(process.env.HOME || '~', '.lito', 'templates');
+    const cacheDir = join(homedir(), '.lito', 'templates');
     if (existsSync(cacheDir)) {
       const cached = readdirSync(cacheDir).length;
       log.message(`  ${pc.cyan('Cached templates:')} ${cached}`);

src/commands/preview.js

@@ -71,7 +71,8 @@ export async function previewCommand(options) {
     } catch (serveError) {
       // Fallback to Python's http.server if serve isn't available
       try {
-        await execa('python3', ['-m', 'http.server', port, '-d', outputPath], {
+        const pythonCmd = process.platform === 'win32' ? 'python' : 'python3';
+        await execa(pythonCmd, ['-m', 'http.server', port, '-d', outputPath], {
           stdio: 'inherit',
           cwd: process.cwd(),
         });

src/core/template-fetcher.js

@@ -123,13 +123,13 @@ export async function fetchGitHubTemplate(owner, repo, ref) {
 
   // Use tar to extract (available on all Unix systems and modern Windows)
   const { execa } = await import('execa');
-  const isWin = process.platform === 'win32';
+  // Use forward slashes on Windows to avoid bsdtar issues with drive letters (C:)
+  const tarPath = tempTarPath.replace(/\\/g, '/');
+  const extractPath = cachePath.replace(/\\/g, '/');
   const tarArgs = [
-    '-xzf', isWin ? tempTarPath.replace(/\\/g, '/') : tempTarPath,
-    '-C', isWin ? cachePath.replace(/\\/g, '/') : cachePath,
-    '--strip-components=1',
-    // On Windows, GNU tar misinterprets drive letters (C:) as remote hosts
-    ...(isWin ? ['--force-local'] : [])
+    '-xzf', tarPath,
+    '-C', extractPath,
+    '--strip-components=1'
   ];
   await execa('tar', tarArgs);