@devries-cameron20 / composio Mirror · read-only / commits / 78309e8d2
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 08:15 UTC

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