Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
Merge remote-tracking branch 'origin/next' into feat/connected-accounts-experimental-py
venkat8244972d90add5
diff --cc ts/packages/cli/AGENTS.mdindex 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```typescriptEffect.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;});```