TOOL / SCRIPT

f-create.sh: "The Rocket" File & Folder Creator

stable

Stable: This tool is production-ready, well-tested, and actively maintained. It's been battle-tested across multiple projects and is ready for serious use. Found a bug or have suggestions? Open an issue on GitHub.

Used daily across projects, saves 80% of manual file creation time

BashCLIAutomationDevOps

Supercharged file and folder creation wizard with smart detection, batch processing, undo functionality, and auto-content generation. Evolution from basic mkdir/touch to a full-featured development tool.

View Source

time Saved

80%

features

15+

tests

What It Does

f-create.sh "The Rocket" is a supercharged evolution from basic mkdir/touch commands. It's a file creation wizard that magically detects whether you're creating files or folders, provides colorful feedback with emojis, supports batch processing, undo functionality, auto-content generation, and comes with a comprehensive test suite. Think of it as the Swiss Army knife of file creation.

The Problem

Creating nested directory structures and files manually with mkdir and touch was tedious and error-prone. Accidentally overwriting files, forgetting to create parent directories, and having no way to undo bulk operations made file management frustrating. As a developer working on multiple projects, I needed a smarter way to scaffold file structures quickly and safely.

The Solution

f-create.sh automates the entire file creation process with intelligent detection and safety features. It automatically creates nested directories, detects file vs folder intentions, warns before overwriting, supports batch operations, and provides full undo functionality with batch tracking. Now I can create complex project structures in seconds with confidence, knowing I can always undo if needed.

Key Features

Smart file vs folder detection (extensionless files like README, Dockerfile)

Batch processing for multiple files and directories

Full undo functionality with batch tracking and time travel

Auto-content generation for common file types (scripts, configs)

Custom permission setting with chmod integration

Dry-run mode for safe previewing

Overwrite protection with interactive warnings

Comprehensive path validation and safety checks

Colorful output with emoji feedback

History tracking with persistent operation logs

Backup system for safe file removal during undo

Extensionless file recognition (README, LICENSE, Makefile, etc.)

Force type options for edge cases

Verbose and quiet modes for different workflows

27-test comprehensive test suite

Usage Examples

Help Output (f-create -h)

Complete help output showing all available options and features

🚀 The Rocket - Enhanced File and Directory Creator

Usage: f-create [OPTIONS] <path1> [path2] [path3] ...

OPTIONS:
  -h, --help          Show this help message
  -q, --quiet         Quiet mode (no emojis/colors)
  -v, --verbose       Verbose mode (show detailed info)
  -n, --dry-run       Show what would be done without doing it
  -f, --file          Force treat as file (even without extension)
  -d, --dir           Force treat as directory (even with extension)
  -c, --content TEXT  Add initial content to files
  -e, --edit          Open file in editor after creation
  --chmod PERMS       Set file permissions (e.g., 755, 644)
  -u, --undo          Undo the last operation

FEATURES:
📁 Creates nested directories safely
📝 Creates files with smart content detection
📂 Auto-detects files vs folders intelligently
🔧 Supports common extensionless files (README, Dockerfile, etc.)
⚠️  Warns about overwriting with backup creation
🔒 Enhanced security and validation
📊 Batch processing support
🎯 Dry-run mode to preview changes
🔍 Verbose and quiet modes
✨ Smart default content for common file types

EXTENSIONLESS FILES DETECTED AS FILES:
README, LICENSE, CHANGELOG, Dockerfile, Makefile, Vagrantfile,
Gemfile, Procfile

CONFIGURATION:
Max path depth: 20 levels
Min disk space: 100MB
Backup directory: .f-create-backups/
History file: .f-create-history

Basic Usage Examples

Common usage patterns from the help examples

# Basic usage
f-create demo/demo.txt
f-create demo/test/first                    # Creates folders
f-create projects/backend/                  # Creates folders (ends with /)

# Force type
f-create README --file                      # Force as file
f-create script.backup --dir               # Force as directory

# With content and permissions
f-create script.sh --content '#!/bin/bash\necho "Hello"' --chmod 755
f-create index.html --edit                 # Open in editor after creation

Advanced Operations

Batch processing, preview mode, and undo functionality

# Batch mode
f-create file1.txt file2.js folder1/ folder2/

# Dry run
f-create complex/structure/file.txt --dry-run

# Quiet/Verbose modes
f-create file.txt --quiet
f-create file.txt --verbose

# Undo last operation
f-create --undo

What's Next

Features I'm thinking about adding slowly:

→

Template system for common project structures

→

Git integration for automatic .gitignore creation

→

IDE integration for seamless workflow

→

Project scaffolding presets (React, Node.js, Python, etc.)

→

Remote file creation over SSH

→

Integration with other automas tools (DBM, NGX, Aetherix)

License - MIT

This tool is open source and free to use. You're welcome to use, modify, and distribute it for any purpose, including commercial projects. Attribution is appreciated but not required.

✓ You can:

•Use for personal or commercial projects
•Modify and adapt to your needs
•Distribute and share freely
•Include in your own projects

ℹ️ Please note:

•Provided "as is" without warranty
•Attribution appreciated but optional
•No liability for any damages

Questions or feedback? zothstic@gmail.com