effect-ts

Effect repository setup

Install Effect

Use the repository's package manager. For a new setup, upstream targets the current stable release:

bun add effect@latest

Preserve an existing Effect version unless an upgrade was requested. For a v3-to-v4 upgrade, use /effect-v3-to-v4 instead of treating it as a fresh installation.

In a monorepo, install Effect as a root dev dependency when needed to expose the source and agent guide from node_modules/effect:

bun add -D effect@latest

Keep runtime dependencies in the packages that import Effect. Verify that node_modules/effect/AGENTS.md and node_modules/effect/src exist before adding the instruction below; if absent, report the installed version and missing files.

Update agent instructions

Add this block to the repository's canonical agent-instruction source. Regenerate any derived AGENTS.md or CLAUDE.md; do not hand-edit generated instructions.

# Learning more about Effect

This repository uses the Effect TypeScript library.

Before writing any Effect code, read `node_modules/effect/AGENTS.md` completely
and follow its links when required.

For APIs and concepts not covered by that guide, search the installed source in
`node_modules/effect/src`.

For subsequent Effect composition or review, load Effect development. Setup stays here; the installed dependency remains the version authority.