Skip to content

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

Merge remote-tracking branch 'origin/next' into feat/connected-accounts-experimental-py

venkat8244972d90add5
diff --cc ts/packages/cli/AGENTS.md
index d61092e6a,f7445f453..36e547b21
--- a/ts/packages/cli/AGENTS.md
+++ b/ts/packages/cli/AGENTS.md
@@@ -21,27 -21,44 +21,44 @@@ Bootstraps the CLI by composing Effect
- `UpgradeBinaryLive` — Self-update from GitHub releases
- `BunFileSystem.layer`, `BunContext.layer` — Bun runtime integration
- Errors are captured via the custom `effect-errors/` module, which provides source-mapped stack traces, Effect span timelines, and formatted output.
-
- ### Commands (`src/commands/`)
-
- Each command is declared with `@effect/cli`'s `Command.make()` pattern:
-
- | Command | Description |
- | -------------------------------------------------------- | ------------------------------------------------------------------------------------- |
- | `composio version` | Display CLI version |
- | `composio whoami` | Show logged-in user's API key |
- | `composio login [--no-browser] [--no-wait] [--key text] [--user-api-key text] [--org text]` | Login with browser redirect or direct user API key |
- | `composio logout` | Clear stored API key |
- | `composio upgrade` | Self-update binary from GitHub releases |
- | `composio generate` | Auto-detect project language, delegate to `ts` or `py` |
- | `composio generate ts` | Generate TypeScript type stubs for toolkits/tools/triggers |
- | `composio generate py` | Generate Python type stubs |
- | `composio manage <command>` | Manage Composio resources (toolkits, tools, accounts, triggers, logs, orgs, projects) |
-
- Options use `Options.text()`, `Options.boolean()`, `Options.choice()`, `Options.directory()` with Effect Schema validation.
-
- ### Services (`src/services/`)
+ Errors are captured via the custom `effect-errors/` module (source-mapped stack traces, Effect span timelines, formatted output).
+
+ ### Commands — `src/commands/`
+
+ Each command uses `@effect/cli`'s `Command.make()` pattern. Top-level command files end in `.cmd.ts`; nested command groups live in their own subdirectory with a `<group>.cmd.ts` entry. Current top-level commands:
+
-| Group / Command | Purpose |
-| ------------------------- | ------------------------------------------------------------------------------------------------------ |
-| `version` | Display CLI version |
-| `whoami` | Show logged-in user info (writes raw API key to stdout when piped — see Output Conventions) |
-| `login` | Login with browser redirect or direct user/API key (`--no-browser`, `--no-wait`, `--key`, `--user-api-key`, `--org`) |
-| `logout` | Clear stored API key |
-| `signup` | Create a Composio account |
-| `upgrade` | Self-update binary from GitHub releases |
-| `init` | Bootstrap a Composio project in the current directory |
-| `install` | Install local-tool integrations |
-| `generate {ts|py}` | Generate type stubs (auto-detects project language if no subcommand) |
-| `agent` | Manage AI agent presets |
-| `toolkits` | List / inspect / version toolkits |
-| `tools` | List / inspect / `execute` tools |
-| `triggers` | List / manage trigger types |
-| `auth-configs` | Manage auth-config resources (`ac_*`) |
-| `connected-accounts` | Manage connected accounts (`ca_*`) |
-| `connections` | Alias / helper for connected-account flows |
-| `orgs` | Manage organizations |
-| `projects` | Manage projects |
-| `local-tools` | Manage local toolkits (via `@composio/cli-local-tools`) |
-| `logs` | View tool-execution logs (`logs-cmd/`) |
-| `config` | Read/write CLI config |
-| `listen` | Listen for events |
-| `proxy` | Proxy authenticated API requests |
-| `run` | Run a saved script / preset |
-| `dev` | Developer-only utilities |
-| `artifacts` | Manage generated artifacts |
++| Group / Command | Purpose |
++| -------------------- | -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
++| `version` | Display CLI version |
++| `whoami` | Show logged-in user info (writes raw API key to stdout when piped — see Output Conventions) |
++| `login` | Login with browser redirect or direct user/API key (`--no-browser`, `--no-wait`, `--key`, `--user-api-key`, `--org`) |
++| `logout` | Clear stored API key |
++| `signup` | Create a Composio account |
++| `upgrade` | Self-update binary from GitHub releases |
++| `init` | Bootstrap a Composio project in the current directory |
++| `install` | Install local-tool integrations |
++| `generate {ts | py}` | Generate type stubs (auto-detects project language if no subcommand) |
++| `agent` | Manage AI agent presets |
++| `toolkits` | List / inspect / version toolkits |
++| `tools` | List / inspect / `execute` tools |
++| `triggers` | List / manage trigger types |
++| `auth-configs` | Manage auth-config resources (`ac_*`) |
++| `connected-accounts` | Manage connected accounts (`ca_*`) |
++| `connections` | Alias / helper for connected-account flows |
++| `orgs` | Manage organizations |
++| `projects` | Manage projects |
++| `local-tools` | Manage local toolkits (via `@composio/cli-local-tools`) |
++| `logs` | View tool-execution logs (`logs-cmd/`) |
++| `config` | Read/write CLI config |
++| `listen` | Listen for events |
++| `proxy` | Proxy authenticated API requests |
++| `run` | Run a saved script / preset |
++| `dev` | Developer-only utilities |
++| `artifacts` | Manage generated artifacts |
+
+ Options use `Options.text()`, `Options.boolean()`, `Options.choice()`, `Options.directory()` with Effect Schema validation. Feature flags live in `feature-tags.ts` and `experimental-features.ts`.
+
+ ### Services — `src/services/`
| Service | Purpose |
| ---------------------------------- | ---------------------------------------------------------------------------- |
@@@ -125,8 -128,8 +128,8 @@@ Generator-based syntax throughout
```typescript
Effect.gen(function* () {
const service = yield* ServiceName; // resolve dependency
- const result = yield* someEffect; // await computation
+ const result = yield* someEffect; // await computation
- yield* Effect.log('message'); // side effect
+ yield* Effect.log('message');
return result;
});
```