Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
chore: add Effect-TS/effect submodule and update agent docs
Add a git submodule reference to Effect-TS/effect at ts/vendor/effect so AI coding agents have a local copy of the Effect source code to reference when generating CLI code. - Add submodule tracking main branch at ts/vendor/effect/ - Add "Effect.ts Reference Source" section to root CLAUDE.md - Create Cursor rule for Effect source patterns in CLI package - Enable submodule checkout in claude.yml GitHub Actions workflow 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
jkomyno committed
Feb 18, 2026 at 10:40 UTC
78309e8d256e1ff98f6956eefb7f7935350b6f37
5 files changed
+42
.github/workflows/claude.yml
+1
@@ -28,6 +28,7 @@ jobs:
28
uses: actions/checkout@v6
29
with:
30
fetch-depth: 1
31
+ submodules: true
32
33
- name: Run Claude Code
34
id: claude
.gitmodules
new
+4
@@ -0,0 +1,4 @@
1
+[submodule "ts/vendor/effect"]
2
+ path = ts/vendor/effect
3
+ url = git@github.com:Effect-TS/effect.git
4
+ branch = main
CLAUDE.md
+15
@@ -10,6 +10,21 @@ This is the Composio SDK v3 repository containing both TypeScript and Python SDK
10
11
- For documentation tasks, refer to `fern/CLAUDE.md`
12
13
+## Effect.ts Reference Source
14
+
15
+The CLI package (`@composio/cli`) is built on the Effect.ts ecosystem. A local copy of the Effect source code is available as a git submodule:
16
+
17
+- **Location:** `ts/vendor/effect/`
18
+- **Repo:** [Effect-TS/effect](https://github.com/Effect-TS/effect)
19
+- **Branch:** `main`
20
+
21
+When working on CLI code, reference the Effect source for accurate patterns:
22
+- `ts/vendor/effect/packages/effect/src/` — core Effect runtime
23
+- `ts/vendor/effect/packages/cli/src/` — @effect/cli (Command, Options, Args)
24
+- `ts/vendor/effect/packages/platform/src/` — @effect/platform (FileSystem, Terminal)
25
+
26
+**Important:** The submodule is for **read-only reference only**. Do not modify files in `ts/vendor/`. The CLI's actual dependencies come from npm via `pnpm install`.
27
+
28
## Common Development Commands
29
30
### Build and Development
ts/packages/cli/.cursor/rules/effect-source-reference.mdc
new
+21
@@ -0,0 +1,21 @@
1
+---
2
+description: Reference Effect source code for accurate patterns
3
+globs:
4
+ - "src/**/*.ts"
5
+alwaysApply: true
6
+---
7
+
8
+# Effect Source Code Reference
9
+
10
+A local copy of the Effect source is available at `ts/vendor/effect/`.
11
+
12
+When writing or modifying CLI code that uses Effect APIs, consult:
13
+- `ts/vendor/effect/packages/cli/src/` for @effect/cli patterns (Command, Options, Args)
14
+- `ts/vendor/effect/packages/effect/src/` for core Effect patterns (Effect.gen, Layer, Service)
15
+- `ts/vendor/effect/packages/platform/src/` for @effect/platform patterns (FileSystem, Terminal)
16
+
17
+Key patterns used in this CLI:
18
+- Commands defined with `Command.make().pipe(Command.withHandler(...))`
19
+- Options defined with `Options.text()`, `Options.boolean()`, etc.
20
+- Services as `Effect.Service<T>()` classes with Layer composition
21
+- Error handling with tagged errors and `Effect.gen(function* () { ... })`
ts/vendor/effect
new
+1
@@ -0,0 +1 @@
1
+Subproject commit 4f2107548fa64c21a8643b7b0efcd556cd16d4b9