sahiixx/file-utils

File Utilities

File system operations for reading, writing, and searching files.

Quick Start

List Directory

node /path/to/skills/file-utils/scripts/list.js /path/to/directory

Read File

node /path/to/skills/file-utils/scripts/read.js /path/to/file.txt

Write File

node /path/to/skills/file-utils/scripts/write.js /path/to/file.txt "Content to write"

Search Files

node /path/to/skills/file-utils/scripts/search.js /path/to/dir "pattern" --content

Scripts

list.js

List directory contents with details.

Usage:

node list.js <path> [OPTIONS]

Options:

• --recursive or -r - List recursively
• --tree - Show as tree view
• --hidden - Include hidden files
• --json - Output as JSON

read.js

Read file contents.

Usage:

node read.js <path> [OPTIONS]

Options:

• --lines <start>:<end> - Read specific line range
• --head <n> - Read first n lines
• --tail <n> - Read last n lines
• --json - Parse as JSON

write.js

Write content to a file.

Usage:

node write.js <path> <content> [OPTIONS]

Options:

• --append - Append to existing file
• --mkdir - Create parent directories

search.js

Search for files or content.

Usage:

node search.js <path> <pattern> [OPTIONS]

Options:

• --content - Search file contents (default: filename)
• --ignore-case or -i - Case insensitive search
• --max <n> - Maximum results (default: 100)

Examples

Tree View of Project

node list.js . --tree --recursive

Read Lines 10-20

node read.js file.txt --lines 10:20

Find All JavaScript Files

node search.js . "\.js$"

Search for Text in Files

node search.js ./src "TODO" --content

Output Format

list.js (JSON mode)

[
  { "name": "file.txt", "type": "file", "size": 1234, "modified": "2024-01-15T10:30:00Z" }
]

search.js

{
  "pattern": "TODO",
  "matches": [
    { "file": "src/index.js", "line": 42, "content": "// TODO: fix this" }
  ],
  "count": 1
}