Documentation/Frameworks/Effect
🏗ī¸

Effect

v1.3.0Apache 2.0

Effect validation and type checking for TypeScript projects using the Effect library.

frameworksskillhookeffecttypescriptfunctional-programmingtype-safetydependency-injection

Installation

Install han binary (required for hooks to work):

curl -fsSL https://han.guru/install.sh | bash

Then install this plugin:

han plugin install effect

Overview

Effect validation and type checking for TypeScript projects using the Effect library.

Hooks

This plugin provides validation hooks that run TypeScript compiler checks:

Stop Hooks

Runs tsc --noEmit in all directories with a tsconfig.json file to validate TypeScript compilation without emitting files.

The hooks will:

  • Discover all directories containing tsconfig.json
  • Run tsc --noEmit in each directory
  • Stop on the first failure with --fail-fast
  • Exit with code 2 if any compilation errors are found

Skills

This plugin includes skills for working with Effect:

  • effect-core-patterns - Basic Effect<A, E, R> patterns, succeed/fail/sync/async
  • effect-error-handling - Type-safe error handling with catchAll, catchTag, etc.
  • effect-dependency-injection - Layer pattern for dependency management
  • effect-schema - Schema validation with @effect/schema
  • effect-concurrency - Fiber-based concurrency, parallel execution
  • effect-resource-management - Scope, Resource, and automatic cleanup
  • effect-testing - Testing Effect code with Effect.gen and test utilities

Usage

Install this plugin in your Claude Code configuration to automatically validate TypeScript compilation on Stop events and access Effect-specific skills.

Installation

Install with npx (no installation required):

bash
han plugin install jutsu-effect

Skills

📖

effect-concurrency

Use when Effect concurrency patterns including fibers, fork, join, parallel execution, and race conditions. Use for concurrent operations in Effect applications.

📖

effect-core-patterns

Use when Effect core patterns including Effect<A, E, R> type, succeed, fail, sync, promise, and Effect.gen for composing effects. Use for basic Effect operations.

📖

effect-dependency-injection

Use when Effect dependency injection patterns including Context, Layer, service definitions, and dependency composition. Use for managing dependencies in Effect applications.

📖

effect-error-handling

Use when Effect error handling patterns including catchAll, catchTag, either, option, and typed errors. Use for handling expected errors in Effect applications.

📖

effect-resource-management

Use when Effect resource management patterns including Scope, addFinalizer, scoped effects, and automatic cleanup. Use for managing resources in Effect applications.

📖

effect-schema

Use when @effect/schema patterns including schema definition, validation, parsing, encoding, and transformations. Use for type-safe data validation in Effect applications.

📖

effect-testing

Use when testing Effect code including Effect.gen in tests, test layers, mocking services, and testing error scenarios. Use for writing tests for Effect applications.

Hooks

⚠ī¸

Token Usage Notice

Hooks run automatically during Claude Code sessions and their output is sent to the model for processing. This may increase token usage and associated costs. Consider disabling hooks you don't need via han-config.yml.

🛑

Stop

Runs when the main Claude Code agent has finished responding. Can verify task completion, check quality gates, or ensure documentation requirements are met before the session ends.

npx -y --package typescript tsc