effect-filesystem

Replace node:fs with effect-based FileSystem and Path services.

5|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/agentxm/axm --skill effect-filesystem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: effect-filesystem
Source: https://github.com/agentxm/axm/tree/main/.axm/extensions/%40axm/skills/effect-filesystem/src
Command: npx skills add https://github.com/agentxm/axm --skill effect-filesystem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Effect-based services provide FileSystem and Path to replace direct node:fs/node:path usage, ensuring deterministic I/O in the CLI runtime environment.

Core Features & Use Cases

  • Uses effect/FileSystem and effect/Path to perform filesystem I/O in production code
  • Enforces safer path management and error wrapping within Effect-driven workflows
  • Works with NodeServices.layer to provide FileSystem and Path services in tests and runtime

Quick Start

Start using effect/FileSystem and effect/Path instead of node:fs and node:path to perform file I/O and path operations in your code.

Frequently Asked Questions about effect-filesystem

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle filesystem I/O in Node.js using the Effect runtime?

Filesystem I/O in Node.js using the Effect runtime is handled by using the FileSystem and Path services from the effect library instead of direct node:fs or node:path modules. This ensures deterministic I/O and safer path management.

Why should I replace node:fs with effect-based filesystem services?

Replacing node:fs with effect-based filesystem services ensures deterministic I/O within the CLI runtime environment and enforces safer path management with structured error wrapping. It prevents direct node:fs usage in production code.

How do I set up FileSystem and Path services for Effect tests?

To set up FileSystem and Path services for Effect tests, you need to provide them using NodeServices.layer. This layer supplies the necessary context to execute filesystem operations safely during testing and runtime.

Can I use effect/Path for directory manipulation in a CLI app?

Yes, you can use effect/Path for directory manipulation in a Node.js CLI app. It works alongside effect/FileSystem to handle path computations and file operations safely within an Effect-driven workflow.

What are the limitations of using effect-based filesystem operations?

The primary limitation is that it strictly enforces avoiding node:fs in production code, requiring all file reading, writing, and directory manipulation to route through Effect's runtime services using NodeServices.layer.

Does effect-filesystem work with Node.js server apps?

Yes, effect-filesystem applies to Node.js server apps that perform file reading, writing, and path computations. It uses an Effect-based runtime to provide deterministic I/O and error wrapping for server-side workflows.