Search for files in a local directory by name pattern and/or extension.

Supports recursive subdirectory search with configurable depth. Returns matching file paths with size and modification time.

Args:

• directory (string): Base directory to search

• pattern (string, optional): Filename pattern (e.g., .js, report)

• extension (string, optional): Filter by extension without dot (e.g., txt, json)

• recursive (boolean): Search subdirectories (default: true)

• max_depth (number): Max recursion depth 1-10 (default: 3)

• limit (number): Max results 1-200 (default: 50)

• response_format ('markdown' | 'json'): Output format (default: 'markdown')

Examples:

• Find all JS files: directory="/project", extension="js"

• Search by name: directory="/docs", pattern="report"

• Quick top-level scan: directory="/", recursive=false, limit=20

Security:

• Paths are sanitized and access is validated before any filesystem operation.

• Only accessible files and directories are returned.

Retrieve basic system information including OS, CPU, memory, uptime, and user details.

Useful for understanding the environment the AI is running in. All information is read-only and comes from the Node.js os module.

Args:

• response_format ('markdown' | 'json'): Output format (default: 'markdown')

Returns:

• OS type, platform, release version

• CPU model and core count

• Total and free memory

• System uptime

• Current user and home directory

• Hostname

List files and folders in a directory with size, modification time, and type information.

Supports pagination and optional hidden file inclusion. Results are sorted: directories first, then files.

Args:

• directory (string): Directory path to list

• show_hidden (boolean): Include hidden files (default: false)

• limit (number): Max entries 1-200 (default: 50)

• offset (number): Pagination offset (default: 0)

• response_format ('markdown' | 'json'): Output format (default: 'markdown')

Returns: For JSON: { total, count, offset, entries: [{name, type, size, size_formatted, modified}], has_more, next_offset }

Get detailed metadata about a file or directory, including size, modification time, creation time, permissions, and type.

Also returns a small preview of text-based files (up to 1000 bytes).

Args:

• file_path (string): Absolute path to the file

• response_format ('markdown' | 'json'): Output format (default: 'markdown')

Returns: For JSON: { path, type, size, size_formatted, created, modified, accessed, permissions, is_readable, is_writable, ...preview }

Security:

• Only returns metadata; never writes or modifies files.

• Path access is validated before reading.