{"owner":"ComposioHQ","repo":"composio","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md","CLAUDE.md"],"skills":{"AGENTS.md":"# AGENTS.md\n\nRepository guidance for Codex, Claude Code, Cursor, pi.dev, and other AI coding agents.\n\n## Scope\n\nThis is the Composio SDK v3 monorepo. Most product code lives in `ts/` and `python/`; docs live in `docs/`. Branch new work from `next` and target PRs at `next` unless the user says otherwise.\n\n## First Steps\n\n1. Read the nearest nested `AGENTS.md` before editing a subtree.\n2. Preserve unrelated dirty work. Do not revert, delete, or reformat files outside the requested scope.\n3. Treat `.agents/skills` as the canonical local skill tree. `.claude/skills` is a compatibility symlink and must not be edited as a separate copy.\n4. Do not edit generated SDK surfaces or vendor trees — see [Generated And Vendored Paths](#generated-and-vendored-paths).\n5. Verify every command you write against the current `package.json`, `Makefile`, `noxfile.py`, or workflow file.\n\n## Skill Routing\n\nUse the smallest relevant skill:\n\n- `repo-guidance`: repo layout, branch/PR workflow, changesets, generated files, or cross-repo maintenance.\n- `skill-maintenance`: adding or changing local skills, skill references, compatibility mirrors, or validation.\n- `bug-fixing`: fixing a defect and choosing regression tests.\n- `cross-sdk-parity`: aligning TypeScript and Python behavior, generated client bumps, or API contract drift.\n- `docs-decisions`: docs site work, changelogs, docs decisions, or docs automation.\n- `good-docs-writing`: drafting or revising docs prose in the house writing voice.\n- `good-docs-audit`: reviewing existing docs or prose against that voice and reporting violations.\n- `eve`: durable backend AI agents built with the eve framework.\n- `typescript-sdk`, `typescript-testing`, `typescript-providers`: TypeScript SDK/core/provider work.\n- `cli-command`, `cli-e2e`: CLI design/implementation or CLI end-to-end tests.\n- `cli-release`: first-party CLI beta builds, stable promotion, release verification, or recovery.\n- `python-sdk`, `python-testing`, `python-providers`, `python-release`: Python SDK/provider/testing/release work.\n\n## Repository Map\n\n```text\nts/                         TypeScript SDK workspace\n  packages/core/            @composio/core\n  packages/providers/       TypeScript provider adapters\n  packages/cli/             Effect-based CLI\n  e2e-tests/                Docker runtime and CLI E2E tests\npython/                     Python SDK and provider packages\ndocs/                       Fumadocs documentation site\n.agents/skills/             Canonical local agent skills\ndocs/agent-guidance/        Neutral docs-agent context and workflow instructions\ndocs/decisions/             Neutral docs decisions and ADR-style records\n```\n\n## Generated And Vendored Paths\n\nDo not hand-edit these. They are regenerated or vendored, and edits will be overwritten. They are also marked `linguist-generated`/`linguist-vendored` in `.gitattributes`.\n\n- `ts/vendor/**` — vendored read-only snapshots of Effect and Clack (git submodules); reference only.\n- `ts/packages/cli-local-tools/vendor/**` — vendored local-tool sources (git submodules).\n- `ts/packages/core/generated/**`, `ts/packages/core/pack/generated/**` — generated SDK surfaces produced by `composio generate` / the build pipeline.\n- `pnpm-lock.yaml`, `uv.lock`, `**/bun.lock` — package-manager lockfiles; change them by running the package manager, never by hand.\n\n## Common Commands\n\nUse `mise install` for the pinned toolchain. pnpm is managed through mise, not Corepack.\n\n```bash\npnpm install\npnpm build\npnpm build:packages\npnpm lint\npnpm format\npnpm typecheck\npnpm test\npnpm test:e2e\npnpm test:e2e:cli\npnpm validate:agent-skills\npnpm validate:skill-routing\n```\n\nPython commands run from `python/` unless otherwise noted:\n\n```bash\nmake env\nsource .venv/bin/activate\nmake fmt\nmake chk\nmake tst\nmake snt\nmake build\n```\n\n## Release And Package Notes\n\n- TypeScript package releases use Changesets. Add a changeset only when published TypeScript packages change.\n- `@composio/cli` and `@composio/cli-local-tools` are excluded from Changesets; use `cli-release` for CLI binaries and never target those packages in a changeset while they remain ignored.\n- Documentation-only and agent-guidance-only changes do not need a changeset.\n- Python release metadata lives in `python/pyproject.toml`, `python/setup.py`, and `uv.lock`.\n- Bumping generated clients is manual. Verify the package version is published before changing pins.\n\n## Local Guidance Files\n\n- TypeScript workspace: `ts/AGENTS.md`\n- Core SDK: `ts/packages/core/AGENTS.md`\n- TypeScript providers: `ts/packages/providers/AGENTS.md`\n- CLI: `ts/packages/cli/AGENTS.md`\n- E2E tests: `ts/e2e-tests/AGENTS.md`\n- Python SDK: `python/AGENTS.md`\n- Python providers: `python/providers/AGENTS.md`\n- Docs: `docs/AGENTS.md`\n","CLAUDE.md":"# CLAUDE.md\n\nClaude Code compatibility shim.\n\nUse `AGENTS.md` for repository guidance. Local skills are canonical under `.agents/skills`; `.claude/skills` points there for Claude-compatible clients.\n"},"files":{"AGENTS.md":"# AGENTS.md\n\nRepository guidance for Codex, Claude Code, Cursor, pi.dev, and other AI coding agents.\n\n## Scope\n\nThis is the Composio SDK v3 monorepo. Most product code lives in `ts/` and `python/`; docs live in `docs/`. Branch new work from `next` and target PRs at `next` unless the user says otherwise.\n\n## First Steps\n\n1. Read the nearest nested `AGENTS.md` before editing a subtree.\n2. Preserve unrelated dirty work. Do not revert, delete, or reformat files outside the requested scope.\n3. Treat `.agents/skills` as the canonical local skill tree. `.claude/skills` is a compatibility symlink and must not be edited as a separate copy.\n4. Do not edit generated SDK surfaces or vendor trees — see [Generated And Vendored Paths](#generated-and-vendored-paths).\n5. Verify every command you write against the current `package.json`, `Makefile`, `noxfile.py`, or workflow file.\n\n## Skill Routing\n\nUse the smallest relevant skill:\n\n- `repo-guidance`: repo layout, branch/PR workflow, changesets, generated files, or cross-repo maintenance.\n- `skill-maintenance`: adding or changing local skills, skill references, compatibility mirrors, or validation.\n- `bug-fixing`: fixing a defect and choosing regression tests.\n- `cross-sdk-parity`: aligning TypeScript and Python behavior, generated client bumps, or API contract drift.\n- `docs-decisions`: docs site work, changelogs, docs decisions, or docs automation.\n- `good-docs-writing`: drafting or revising docs prose in the house writing voice.\n- `good-docs-audit`: reviewing existing docs or prose against that voice and reporting violations.\n- `eve`: durable backend AI agents built with the eve framework.\n- `typescript-sdk`, `typescript-testing`, `typescript-providers`: TypeScript SDK/core/provider work.\n- `cli-command`, `cli-e2e`: CLI design/implementation or CLI end-to-end tests.\n- `cli-release`: first-party CLI beta builds, stable promotion, release verification, or recovery.\n- `python-sdk`, `python-testing`, `python-providers`, `python-release`: Python SDK/provider/testing/release work.\n\n## Repository Map\n\n```text\nts/                         TypeScript SDK workspace\n  packages/core/            @composio/core\n  packages/providers/       TypeScript provider adapters\n  packages/cli/             Effect-based CLI\n  e2e-tests/                Docker runtime and CLI E2E tests\npython/                     Python SDK and provider packages\ndocs/                       Fumadocs documentation site\n.agents/skills/             Canonical local agent skills\ndocs/agent-guidance/        Neutral docs-agent context and workflow instructions\ndocs/decisions/             Neutral docs decisions and ADR-style records\n```\n\n## Generated And Vendored Paths\n\nDo not hand-edit these. They are regenerated or vendored, and edits will be overwritten. They are also marked `linguist-generated`/`linguist-vendored` in `.gitattributes`.\n\n- `ts/vendor/**` — vendored read-only snapshots of Effect and Clack (git submodules); reference only.\n- `ts/packages/cli-local-tools/vendor/**` — vendored local-tool sources (git submodules).\n- `ts/packages/core/generated/**`, `ts/packages/core/pack/generated/**` — generated SDK surfaces produced by `composio generate` / the build pipeline.\n- `pnpm-lock.yaml`, `uv.lock`, `**/bun.lock` — package-manager lockfiles; change them by running the package manager, never by hand.\n\n## Common Commands\n\nUse `mise install` for the pinned toolchain. pnpm is managed through mise, not Corepack.\n\n```bash\npnpm install\npnpm build\npnpm build:packages\npnpm lint\npnpm format\npnpm typecheck\npnpm test\npnpm test:e2e\npnpm test:e2e:cli\npnpm validate:agent-skills\npnpm validate:skill-routing\n```\n\nPython commands run from `python/` unless otherwise noted:\n\n```bash\nmake env\nsource .venv/bin/activate\nmake fmt\nmake chk\nmake tst\nmake snt\nmake build\n```\n\n## Release And Package Notes\n\n- TypeScript package releases use Changesets. Add a changeset only when published TypeScript packages change.\n- `@composio/cli` and `@composio/cli-local-tools` are excluded from Changesets; use `cli-release` for CLI binaries and never target those packages in a changeset while they remain ignored.\n- Documentation-only and agent-guidance-only changes do not need a changeset.\n- Python release metadata lives in `python/pyproject.toml`, `python/setup.py`, and `uv.lock`.\n- Bumping generated clients is manual. Verify the package version is published before changing pins.\n\n## Local Guidance Files\n\n- TypeScript workspace: `ts/AGENTS.md`\n- Core SDK: `ts/packages/core/AGENTS.md`\n- TypeScript providers: `ts/packages/providers/AGENTS.md`\n- CLI: `ts/packages/cli/AGENTS.md`\n- E2E tests: `ts/e2e-tests/AGENTS.md`\n- Python SDK: `python/AGENTS.md`\n- Python providers: `python/providers/AGENTS.md`\n- Docs: `docs/AGENTS.md`\n","CLAUDE.md":"# CLAUDE.md\n\nClaude Code compatibility shim.\n\nUse `AGENTS.md` for repository guidance. Local skills are canonical under `.agents/skills`; `.claude/skills` points there for Claude-compatible clients.\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# AGENTS.md\n\nRepository guidance for Codex, Claude Code, Cursor, pi.dev, and other AI coding agents.\n\n## Scope\n\nThis is the Composio SDK v3 monorepo. Most product code lives in `ts/` and `python/`; docs live in `docs/`. Branch new work from `next` and target PRs at `next` unless the user says otherwise.\n\n## First Steps\n\n1. Read the nearest nested `AGENTS.md` before editing a subtree.\n2. Preserve unrelated dirty work. Do not revert, delete, or reformat files outside the requested scope.\n3. Treat `.agents/skills` as the canonical local skill tree. `.claude/skills` is a compatibility symlink and must not be edited as a separate copy.\n4. Do not edit generated SDK surfaces or vendor trees — see [Generated And Vendored Paths](#generated-and-vendored-paths).\n5. Verify every command you write against the current `package.json`, `Makefile`, `noxfile.py`, or workflow file.\n\n## Skill Routing\n\nUse the smallest relevant skill:\n\n- `repo-guidance`: repo layout, branch/PR workflow, changesets, generated files, or cross-repo maintenance.\n- `skill-maintenance`: adding or changing local skills, skill references, compatibility mirrors, or validation.\n- `bug-fixing`: fixing a defect and choosing regression tests.\n- `cross-sdk-parity`: aligning TypeScript and Python behavior, generated client bumps, or API contract drift.\n- `docs-decisions`: docs site work, changelogs, docs decisions, or docs automation.\n- `good-docs-writing`: drafting or revising docs prose in the house writing voice.\n- `good-docs-audit`: reviewing existing docs or prose against that voice and reporting violations.\n- `eve`: durable backend AI agents built with the eve framework.\n- `typescript-sdk`, `typescript-testing`, `typescript-providers`: TypeScript SDK/core/provider work.\n- `cli-command`, `cli-e2e`: CLI design/implementation or CLI end-to-end tests.\n- `cli-release`: first-party CLI beta builds, stable promotion, release verification, or recovery.\n- `python-sdk`, `python-testing`, `python-providers`, `python-release`: Python SDK/provider/testing/release work.\n\n## Repository Map\n\n```text\nts/                         TypeScript SDK workspace\n  packages/core/            @composio/core\n  packages/providers/       TypeScript provider adapters\n  packages/cli/             Effect-based CLI\n  e2e-tests/                Docker runtime and CLI E2E tests\npython/                     Python SDK and provider packages\ndocs/                       Fumadocs documentation site\n.agents/skills/             Canonical local agent skills\ndocs/agent-guidance/        Neutral docs-agent context and workflow instructions\ndocs/decisions/             Neutral docs decisions and ADR-style records\n```\n\n## Generated And Vendored Paths\n\nDo not hand-edit these. They are regenerated or vendored, and edits will be overwritten. They are also marked `linguist-generated`/`linguist-vendored` in `.gitattributes`.\n\n- `ts/vendor/**` — vendored read-only snapshots of Effect and Clack (git submodules); reference only.\n- `ts/packages/cli-local-tools/vendor/**` — vendored local-tool sources (git submodules).\n- `ts/packages/core/generated/**`, `ts/packages/core/pack/generated/**` — generated SDK surfaces produced by `composio generate` / the build pipeline.\n- `pnpm-lock.yaml`, `uv.lock`, `**/bun.lock` — package-manager lockfiles; change them by running the package manager, never by hand.\n\n## Common Commands\n\nUse `mise install` for the pinned toolchain. pnpm is managed through mise, not Corepack.\n\n```bash\npnpm install\npnpm build\npnpm build:packages\npnpm lint\npnpm format\npnpm typecheck\npnpm test\npnpm test:e2e\npnpm test:e2e:cli\npnpm validate:agent-skills\npnpm validate:skill-routing\n```\n\nPython commands run from `python/` unless otherwise noted:\n\n```bash\nmake env\nsource .venv/bin/activate\nmake fmt\nmake chk\nmake tst\nmake snt\nmake build\n```\n\n## Release And Package Notes\n\n- TypeScript package releases use Changesets. Add a changeset only when published TypeScript packages change.\n- `@composio/cli` and `@composio/cli-local-tools` are excluded from Changesets; use `cli-release` for CLI binaries and never target those packages in a changeset while they remain ignored.\n- Documentation-only and agent-guidance-only changes do not need a changeset.\n- Python release metadata lives in `python/pyproject.toml`, `python/setup.py`, and `uv.lock`.\n- Bumping generated clients is manual. Verify the package version is published before changing pins.\n\n## Local Guidance Files\n\n- TypeScript workspace: `ts/AGENTS.md`\n- Core SDK: `ts/packages/core/AGENTS.md`\n- TypeScript providers: `ts/packages/providers/AGENTS.md`\n- CLI: `ts/packages/cli/AGENTS.md`\n- E2E tests: `ts/e2e-tests/AGENTS.md`\n- Python SDK: `python/AGENTS.md`\n- Python providers: `python/providers/AGENTS.md`\n- Docs: `docs/AGENTS.md`\n","category":"root","tokens":1188},{"name":"CLAUDE.md","path":"CLAUDE.md","title":"CLAUDE.md","content":"# CLAUDE.md\n\nClaude Code compatibility shim.\n\nUse `AGENTS.md` for repository guidance. Local skills are canonical under `.agents/skills`; `.claude/skills` points there for Claude-compatible clients.\n","category":"root","tokens":50}]}