@devries-cameron20 / composio-1 / commits / 36251d101
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.

docs(add): add agent-first setup for developers path

Brendan O'Leary committed Sep 4, 2026 at 15:06 UTC 36251d101221be26e6a0c50dd2a69802356cab98
23 files changed +657 -172
docs/app/(home)/docs/[[...slug]]/page.tsx
+4 -3
@@ -25,9 +25,10 @@ export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
25 full={isLanding ? true : data.full}
26 footer={{ enabled: false }}
27 tableOfContentPopover={{ enabled: false }}
28 - tableOfContent={
29 - data.related?.length ? { footer: <RelatedLinks items={data.related} /> } : undefined
30 - }
28 + tableOfContent={{
29 + single: true,
30 + ...(data.related?.length ? { footer: <RelatedLinks items={data.related} /> } : {}),
31 + }}
32 >
33 {!isLanding && (
34 <>
docs/app/llms.txt/route.ts
+4 -1
@@ -20,6 +20,7 @@ interface PageNode {
20 type: 'page';
21 name: ReactNode;
22 url: string;
23 + external?: boolean;
24 }
25
26 interface SeparatorNode {
@@ -94,7 +95,9 @@ function walkPageTree(nodes: TreeNode[], depth = 2): string {
95
96 switch (node.type) {
97 case 'page':
97 - sectionPages.push(`- https://docs.composio.dev${node.url}.md`);
98 + if (!node.external) {
99 + sectionPages.push(`- https://docs.composio.dev${node.url}.md`);
100 + }
101 break;
102
103 case 'folder': {
docs/components/agent-first-prompt.tsx new
+45
@@ -0,0 +1,45 @@
1 +'use client';
2 +
3 +import { Check, Copy } from 'lucide-react';
4 +import { useEffect, useRef, useState } from 'react';
5 +
6 +const FIRST_PROMPT = `Use the $composio skill to get Composio working in this codebase.
7 +
8 +Help me connect an integration and make my first real tool call.
9 +When it works, show me what changed and what I can try next.`;
10 +
11 +export function AgentFirstPrompt() {
12 + const [copied, setCopied] = useState(false);
13 + const timerRef = useRef<ReturnType<typeof setTimeout>>(undefined);
14 +
15 + useEffect(() => () => clearTimeout(timerRef.current), []);
16 +
17 + const copyPrompt = async () => {
18 + try {
19 + await navigator.clipboard.writeText(FIRST_PROMPT);
20 + clearTimeout(timerRef.current);
21 + setCopied(true);
22 + timerRef.current = setTimeout(() => setCopied(false), 2000);
23 + } catch {
24 + setCopied(false);
25 + }
26 + };
27 +
28 + return (
29 + <aside className="not-prose my-5 rounded-[12px] border border-fd-border bg-fd-card p-4">
30 + <div className="mb-2 flex items-center justify-between gap-4">
31 + <p className="text-[13px] font-medium text-fd-foreground">Try the skill</p>
32 + <button
33 + aria-label="Copy suggested first prompt"
34 + className="inline-flex cursor-pointer items-center gap-1.5 rounded-md px-2 py-1 text-[12px] font-medium text-fd-foreground/65 transition-colors hover:bg-fd-accent hover:text-fd-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-fd-ring"
35 + onClick={copyPrompt}
36 + type="button"
37 + >
38 + {copied ? <Check aria-hidden="true" className="size-3.5" /> : <Copy aria-hidden="true" className="size-3.5" />}
39 + <span aria-live="polite">{copied ? 'Copied' : 'Copy prompt'}</span>
40 + </button>
41 + </div>
42 + <p className="whitespace-pre-line text-[13px] leading-[1.6] text-fd-foreground/70">{FIRST_PROMPT}</p>
43 + </aside>
44 + );
45 +}
docs/components/agent-setup-actions.tsx new
+80
@@ -0,0 +1,80 @@
1 +'use client';
2 +
3 +import { Check, Copy } from 'lucide-react';
4 +import Image from 'next/image';
5 +import Link from 'next/link';
6 +import { useEffect, useRef, useState } from 'react';
7 +import { cn } from '@/lib/utils';
8 +
9 +const SETUP_PROMPT = `Help me add Composio to this project. First, inspect the codebase to understand its framework, agent architecture, authentication, and user or tenant identity model.
10 +
11 +Check whether the official \`composio\` Agent Skill is installed. If it is missing, install it for this project with:
12 +
13 +\`npx skills add ComposioHQ/composio --skill composio\`
14 +
15 +Then load and follow the skill. If installation requires approval, ask for it. If the host does not support skills or installation fails, use the current documentation at [https://docs.composio.dev](https://docs.composio.dev) and report that fallback.
16 +
17 +Default to Composio Platform for application codebases. Use Composio For You only when the project clearly configures a personal agent or automation for the developer’s own accounts.
18 +
19 +Based on the codebase, explain briefly where Composio would fit. Then ask what I want my users or agent to accomplish with connected apps. If the project suggests likely use cases, offer a few relevant options. If it is not clear whether I want to build Composio into the application or connect it to my coding agent, ask me before making changes.`;
20 +
21 +const AGENT_LOGOS = [
22 + { src: '/images/clients/claude.svg', label: 'Claude' },
23 + { src: '/images/clients/codex.png', label: 'Codex' },
24 + { src: '/images/clients/cursor.svg', label: 'Cursor' },
25 +];
26 +
27 +export function AgentSetupActions({ className }: { className?: string }) {
28 + const [copied, setCopied] = useState(false);
29 + const timerRef = useRef<ReturnType<typeof setTimeout>>(undefined);
30 +
31 + useEffect(() => () => clearTimeout(timerRef.current), []);
32 +
33 + const copyPrompt = async () => {
34 + try {
35 + await navigator.clipboard.writeText(SETUP_PROMPT);
36 + clearTimeout(timerRef.current);
37 + setCopied(true);
38 + timerRef.current = setTimeout(() => setCopied(false), 2000);
39 + } catch {
40 + setCopied(false);
41 + }
42 + };
43 +
44 + return (
45 + <div className={cn('flex flex-wrap items-center gap-2.5', className)}>
46 + <Link
47 + className="inline-flex min-h-10 items-center rounded-full border border-fd-border bg-fd-card px-5 text-[14px] font-medium text-fd-foreground no-underline transition-colors hover:bg-fd-accent/50 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-fd-ring"
48 + href="/docs/agent-setup"
49 + >
50 + Agent setup
51 + </Link>
52 + <button
53 + aria-label="Copy Composio setup prompt"
54 + className="group inline-flex min-h-10 cursor-pointer items-center rounded-full border border-fd-border bg-fd-card py-1 pl-1.5 pr-4 text-[14px] font-medium text-fd-foreground transition-colors hover:bg-fd-accent/50 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-fd-ring"
55 + onClick={copyPrompt}
56 + type="button"
57 + >
58 + <span aria-hidden="true" className="mr-3 flex -space-x-1.5">
59 + {AGENT_LOGOS.map(agent => (
60 + <span
61 + className="flex size-7 items-center justify-center rounded-full border border-fd-border bg-fd-background"
62 + key={agent.label}
63 + >
64 + <Image alt="" className="size-4 object-contain" height={16} src={agent.src} width={16} />
65 + </span>
66 + ))}
67 + </span>
68 + <span aria-live="polite">{copied ? 'Prompt copied' : 'Copy prompt'}</span>
69 + {copied ? (
70 + <Check aria-hidden="true" className="ml-2 size-3.5 text-[var(--composio-brand)]" />
71 + ) : (
72 + <Copy
73 + aria-hidden="true"
74 + className="ml-2 size-3.5 text-fd-foreground/45 transition-colors group-hover:text-fd-foreground/70"
75 + />
76 + )}
77 + </button>
78 + </div>
79 + );
80 +}
docs/components/agent-setup-grid.tsx new
+101
@@ -0,0 +1,101 @@
1 +import Image from 'next/image';
2 +import Link from 'next/link';
3 +import { ArrowUpRight } from 'lucide-react';
4 +
5 +const AGENTS = [
6 + {
7 + name: 'Claude Code',
8 + icon: '/images/clients/claude.svg',
9 + href: '/docs/agent-setup/clients#claude-code',
10 + description: 'Install the skill in your project, or use the native Composio plugin for direct app actions.',
11 + },
12 + {
13 + name: 'OpenAI Codex',
14 + icon: '/images/clients/codex.png',
15 + href: '/docs/agent-setup/clients#openai-codex',
16 + description: 'Install the skill in your project, or add the native Codex plugin for direct app actions.',
17 + },
18 + {
19 + name: 'Cursor',
20 + icon: '/images/clients/cursor.svg',
21 + href: '/docs/agent-setup/clients#cursor',
22 + description: 'Add the skill to your project so Cursor can build and configure Composio integrations.',
23 + },
24 + {
25 + name: 'GitHub Copilot',
26 + icon: '/images/clients/vscode.svg',
27 + href: '/docs/agent-setup/clients#github-copilot',
28 + description: 'Give Copilot agent mode the Composio guidance it needs inside your repository.',
29 + },
30 + {
31 + name: 'Gemini CLI',
32 + icon: '/images/clients/gemini.svg',
33 + href: '/docs/agent-setup/clients#gemini-cli',
34 + description: 'Install the skill from your project directory before asking Gemini to add Composio.',
35 + },
36 + {
37 + name: 'OpenClaw',
38 + icon: '/images/clients/openclaw.svg',
39 + href: '/docs/agent-setup/clients#openclaw',
40 + description: 'Install the skill for build guidance, or connect Composio for personal app access.',
41 + },
42 + {
43 + name: 'OpenCode',
44 + icon: '/images/clients/opencode.svg',
45 + href: '/docs/agent-setup/clients#opencode',
46 + description: 'Install the skill in your project so OpenCode can build and configure Composio integrations.',
47 + },
48 + {
49 + name: 'Cline',
50 + icon: '/images/clients/cline.svg',
51 + href: '/docs/agent-setup/clients#cline',
52 + description: 'Add the skill to your repository so Cline can follow the current Composio integration path.',
53 + },
54 + {
55 + name: 'Grok Build',
56 + icon: '/images/clients/grok.svg',
57 + href: '/docs/agent-setup/clients#grok-build',
58 + description: 'Install the skill for Grok Build to add Composio and make your first tool call.',
59 + },
60 +] as const;
61 +
62 +export function AgentSetupGrid() {
63 + return (
64 + <section className="not-prose my-8">
65 + <h2 className="mb-4 text-xl font-medium tracking-[-0.01em] text-fd-foreground sm:text-2xl">
66 + Pick your agent
67 + </h2>
68 + <div className="grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3">
69 + {AGENTS.map(agent => (
70 + <Link
71 + className="group relative rounded-[14px] border border-fd-border bg-fd-card p-4 no-underline shadow-[0_1px_0_rgba(15,15,15,0.04)] transition-[border-color,transform,box-shadow] hover:-translate-y-px hover:border-fd-foreground/20 hover:shadow-[0_8px_20px_-12px_rgba(15,15,15,0.22)] focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-fd-ring"
72 + href={agent.href}
73 + key={agent.name}
74 + >
75 + <ArrowUpRight
76 + aria-hidden="true"
77 + className="absolute right-4 top-4 size-3.5 text-fd-foreground/40 transition-transform group-hover:-translate-y-px group-hover:translate-x-px"
78 + />
79 + <div className="mb-2.5 flex items-center gap-2.5">
80 + <span className="flex size-7 items-center justify-center rounded-[7px] border border-fd-border bg-fd-background">
81 + <Image
82 + alt=""
83 + className={
84 + agent.name === 'Grok Build' ? 'size-4 object-contain dark:invert' : 'size-4 object-contain'
85 + }
86 + height={16}
87 + src={agent.icon}
88 + width={16}
89 + />
90 + </span>
91 + <h3 className="text-[14px] font-medium text-fd-foreground">{agent.name}</h3>
92 + </div>
93 + <p className="text-[12.5px] leading-[1.55] text-fd-foreground/65">
94 + {agent.description}
95 + </p>
96 + </Link>
97 + ))}
98 + </div>
99 + </section>
100 + );
101 +}
docs/components/docs-hero-v2.tsx
+8 -5
@@ -1,17 +1,20 @@
1 import { TOOLKIT_COUNT_LABEL } from '@/lib/toolkit-count';
2 +import { AgentSetupActions } from './agent-setup-actions';
3
4 export function DocsHeroV2() {
5 return (
5 - <section className="py-10 sm:py-12">
6 - <div className="flex max-w-[720px] flex-col gap-5">
6 + <section className="border-b border-fd-border py-9 sm:py-11">
7 + <div className="flex max-w-[760px] flex-col gap-5">
8 <h1 className="text-4xl font-medium leading-[1.05] tracking-[-0.03em] text-fd-foreground sm:text-5xl">
8 - Give agents the tools they need.
9 + Build agents with Composio.
10 </h1>
11
12 <p className="max-w-[620px] text-base leading-[1.6] text-fd-foreground/70 sm:text-lg">
12 - Use Composio to discover tools, authenticate each user, and run
13 - actions across {TOOLKIT_COUNT_LABEL} apps.
13 + Give your agents tools, managed authentication, and secure execution
14 + across {TOOLKIT_COUNT_LABEL} apps.
15 </p>
16 +
17 + <AgentSetupActions />
18 </div>
19 </section>
20 );
docs/components/docs-hero.tsx
+1 -1
@@ -4,7 +4,7 @@ import { DocsHeroV2 } from './docs-hero-v2';
4 /**
5 * Welcome-page hero.
6 *
7 - * Currently rendering the v2 left/right layout. The original ported
7 + * Currently rendering the compact CTA-led layout. The original ported
8 * landing hero (`HeroSection`) is kept under an import comment above —
9 * swap it back in by uncommenting the import and the `<HeroSection />`
10 * line below.
docs/components/home-features.tsx
+5 -5
@@ -36,9 +36,9 @@ run_composio_tool("SLACK_SEND_MESSAGE", {"text": summary})`;
36
37 export function HomeFeatures() {
38 return (
39 - <section className="not-prose mb-20">
39 + <section className="not-prose mb-14">
40 <SectionHeading title="Everything you need to ship production agents." />
41 - <div className="grid grid-cols-1 gap-6 sm:auto-rows-fr sm:grid-cols-2">
41 + <div className="grid grid-cols-1 gap-4 sm:auto-rows-fr sm:grid-cols-2">
42 <FeatureCard
43 title="Tools that resolve by intent."
44 description={`Smart tool search over ${TOOLKIT_COUNT_LABEL} apps, surfaced just in time with the right scope.`}
@@ -82,7 +82,7 @@ function FeatureCard({
82 return (
83 <Link
84 href={href}
85 - className="group relative flex flex-col overflow-hidden border border-fd-border bg-fd-card p-5 no-underline shadow-[0_1px_0_rgba(15,15,15,0.04)] transition-[box-shadow,transform,border-color] duration-200 hover:-translate-y-px hover:border-fd-foreground/15 hover:shadow-[0_10px_24px_-12px_rgba(15,15,15,0.18)] sm:p-6"
85 + className="group relative flex flex-col overflow-hidden rounded-[14px] border border-fd-border bg-fd-card p-5 no-underline shadow-[0_1px_0_rgba(15,15,15,0.04)] transition-[box-shadow,transform,border-color] duration-200 hover:-translate-y-px hover:border-fd-foreground/15 hover:shadow-[0_10px_24px_-12px_rgba(15,15,15,0.18)]"
86 >
87 <ArrowUpRight
88 aria-hidden="true"
@@ -98,7 +98,7 @@ function FeatureCard({
98 </div>
99 <div
100 aria-hidden="true"
101 - className="pointer-events-none mt-6 h-40 select-none"
101 + className="pointer-events-none mt-4 h-28 select-none"
102 style={MOCK_FADE_STYLE}
103 >
104 {visual}
@@ -188,7 +188,7 @@ export function SectionHeading({
188 title: string;
189 }) {
190 return (
191 - <div className="mb-5 flex flex-col gap-1.5">
191 + <div className="mb-4 flex flex-col gap-1.5">
192 {eyebrow && (
193 <span className="font-mono text-[10.5px] uppercase tracking-[0.08em] text-fd-foreground/55">
194 {eyebrow}
docs/components/home-resources.tsx
+3 -3
@@ -57,8 +57,8 @@ const RESOURCES = [
57 */
58 export function HomeResources() {
59 return (
60 - <section className="not-prose mb-12">
61 - <div className="grid grid-cols-1 gap-px border border-fd-border bg-fd-border sm:grid-cols-2 lg:grid-cols-3">
60 + <section className="not-prose mb-10">
61 + <div className="grid grid-cols-1 gap-px overflow-hidden rounded-[14px] border border-fd-border bg-fd-border sm:grid-cols-2 lg:grid-cols-3">
62 {RESOURCES.map((resource) => (
63 <ResourceCard key={resource.title} {...resource} />
64 ))}
@@ -81,7 +81,7 @@ function ResourceCard({
81 return (
82 <Link
83 href={href}
84 - className="group flex flex-col gap-1.5 bg-fd-background p-5 no-underline transition-colors hover:bg-fd-accent/40"
84 + className="group flex flex-col gap-1 bg-fd-background p-4 no-underline transition-colors hover:bg-fd-accent/40"
85 >
86 <div className="flex items-center justify-between">
87 <span className="inline-flex items-center gap-2 text-fd-foreground/80">
docs/components/home-shared.ts
+2 -4
@@ -1,8 +1,6 @@
1 /**
2 - * Bottom fade applied to the Welcome page's product mocks, so each one bleeds
3 - * into its card edge instead of stopping at a hard line. Shared by the
4 - * "Two ways to start" hero cards (`home-surfaces.tsx`) and the feature grid
5 - * (`home-features.tsx`) so the two sections fade identically.
2 + * Bottom fade applied to the Welcome page's feature mocks, so each one bleeds
3 + * into its card edge instead of stopping at a hard line.
4 */
5 export const MOCK_FADE_STYLE = {
6 maskImage: 'linear-gradient(to bottom, black 55%, transparent 100%)',
docs/components/home-surfaces.tsx
+27 -137
@@ -1,31 +1,22 @@
1 -import { ArrowUp, ArrowUpRight, Mic, Plus } from 'lucide-react';
2 -import type { ComponentType } from 'react';
1 +import { ArrowUpRight } from 'lucide-react';
2 import {
3 DOCS_PRODUCTS,
4 HOME_INTENTS,
5 homeIntentAnchor,
6 type HomeIntent,
7 } from '@/lib/home-navigation';
9 -import { MOCK_FADE_STYLE } from './home-shared';
8 import { ProductLockup } from './product-lockup';
9 import { ProductSelectionLink } from './product-selection-link';
12 -
13 -/**
14 - * Each product is described by the same mock the dashboard onboarding
15 - * path step uses for it (composio_dashboard `path-step.tsx`): For You is
16 - * an agent chat composer next to the clients it plugs into, Platform is
17 - * the SDK in a code window — rebuilt here on docs theme tokens so they
18 - * hold up in both color schemes.
19 - */
20 -const INTENT_VISUALS: Record<HomeIntent['id'], ComponentType> = {
21 - build: PlatformVisual,
22 - use: ForYouVisual,
23 -};
10 +import { SectionHeading } from './home-features';
11
12 export function HomeSurfaces() {
13 return (
27 - <section className="not-prose mb-20" id="two-ways-to-start">
28 - <div className="flex flex-col gap-8">
14 + <section className="not-prose mb-14 pt-12 sm:pt-14" id="two-ways-to-start">
15 + <SectionHeading
16 + eyebrow="Choose your path"
17 + title="Start with the product that fits your work."
18 + />
19 + <div className="grid grid-cols-1 gap-4 md:grid-cols-2">
20 {HOME_INTENTS.map(intent => (
21 <IntentCard key={intent.id} intent={intent} />
22 ))}
@@ -35,43 +26,41 @@ export function HomeSurfaces() {
26 }
27
28 function IntentCard({ intent }: { intent: HomeIntent }) {
38 - const Visual = INTENT_VISUALS[intent.id];
39 -
29 return (
41 - <article className="grid overflow-hidden border border-fd-border bg-fd-card shadow-[0_1px_0_rgba(15,15,15,0.04)] md:grid-cols-[minmax(0,1fr)_calc(50%-0.75rem)]">
30 + <article className="flex min-w-0 flex-col overflow-hidden rounded-[14px] border border-fd-border bg-fd-card shadow-[0_1px_0_rgba(15,15,15,0.04)]">
31 <ProductSelectionLink
43 - className="relative overflow-hidden border-b border-fd-border bg-fd-background p-5 pb-40 no-underline transition-colors hover:bg-fd-accent/20 focus-visible:outline-2 focus-visible:outline-offset-[-2px] focus-visible:outline-fd-ring sm:p-6 sm:pb-44 md:min-h-72 md:border-b-0 md:border-r md:pb-6"
32 + className="group border-b border-fd-border bg-fd-background p-5 no-underline transition-colors hover:bg-fd-accent/25 focus-visible:outline-2 focus-visible:outline-offset-[-2px] focus-visible:outline-fd-ring"
33 href={DOCS_PRODUCTS[intent.productId].landingRoute}
34 product={intent.productId}
35 >
47 - <div className="relative z-[1] flex flex-col gap-2.5">
48 - <h3
49 - className="flex items-center gap-2"
50 - id={homeIntentAnchor(intent.product)}
51 - >
52 - <ProductLockup product={intent.productId} />
53 - </h3>
54 - <p className="max-w-[42ch] text-pretty text-[14px] leading-[1.55] text-fd-foreground/70">
55 - {intent.description}
56 - </p>
57 - </div>
58 - <div aria-hidden="true" className="pointer-events-none select-none">
59 - <Visual />
36 + <div className="flex items-start justify-between gap-4">
37 + <div className="flex min-w-0 flex-col gap-2.5">
38 + <h3 className="flex items-center gap-2" id={homeIntentAnchor(intent.product)}>
39 + <ProductLockup product={intent.productId} />
40 + </h3>
41 + <p className="max-w-[42ch] text-pretty text-[15px] font-medium leading-[1.45] text-fd-foreground/85">
42 + {intent.description}
43 + </p>
44 + </div>
45 + <ArrowUpRight
46 + aria-hidden="true"
47 + className="mt-1 size-3.5 shrink-0 text-fd-foreground/40 transition-transform group-hover:-translate-y-px group-hover:translate-x-px"
48 + />
49 </div>
50 </ProductSelectionLink>
51 <ul className="flex flex-col divide-y divide-fd-border">
52 {intent.links.map(link => (
64 - <li className="flex flex-1" key={link.href}>
53 + <li className="flex" key={link.href}>
54 <ProductSelectionLink
66 - className="group flex flex-1 items-center justify-between gap-4 px-4 py-5 no-underline transition-colors hover:bg-fd-accent/40 sm:px-5 sm:py-6"
55 + className="group flex flex-1 items-center justify-between gap-4 px-5 py-3.5 no-underline transition-colors hover:bg-fd-accent/40"
56 href={link.href}
57 product={intent.productId}
58 >
59 <span className="flex min-w-0 flex-col gap-0.5">
71 - <span className="text-[14px] font-medium text-fd-foreground">
60 + <span className="text-[13.5px] font-medium text-fd-foreground">
61 {link.title}
62 </span>
74 - <span className="text-[12.5px] leading-[1.45] text-fd-foreground/65">
63 + <span className="text-[12px] leading-[1.45] text-fd-foreground/60">
64 {link.description}
65 </span>
66 </span>
@@ -86,102 +75,3 @@ function IntentCard({ intent }: { intent: HomeIntent }) {
75 </article>
76 );
77 }
89 -
90 -const FOR_YOU_CLIENT_LOGOS = [
91 - { src: '/images/clients/claude.svg', label: 'Claude' },
92 - { src: '/images/clients/codex.png', label: 'Codex' },
93 - { src: '/images/clients/cursor.svg', label: 'Cursor' },
94 - { src: '/images/clients/openclaw.svg', label: 'OpenClaw' },
95 -];
96 -
97 -function ForYouVisual() {
98 - return (
99 - <div className="absolute inset-x-5 -bottom-3 flex items-end gap-4 sm:inset-x-6">
100 - <div className="grid shrink-0 grid-cols-2 gap-2.5" style={MOCK_FADE_STYLE}>
101 - {FOR_YOU_CLIENT_LOGOS.map(logo => (
102 - <img
103 - alt=""
104 - className="size-8 object-contain"
105 - draggable={false}
106 - key={logo.label}
107 - src={logo.src}
108 - />
109 - ))}
110 - </div>
111 - <div
112 - className="min-w-0 flex-1 rounded-[18px] border border-fd-border bg-fd-card p-3"
113 - style={MOCK_FADE_STYLE}
114 - >
115 - <div className="text-[12px] text-fd-foreground/50">How can I help?</div>
116 - <div className="mt-4 flex items-center gap-2 text-fd-foreground/50">
117 - <Plus className="size-3.5 shrink-0" />
118 - <Mic className="ml-auto size-3.5 shrink-0" />
119 - <span className="flex size-6 shrink-0 items-center justify-center rounded-[8px] bg-[var(--composio-brand)] text-white">
120 - <ArrowUp className="size-3.5" />
121 - </span>
122 - </div>
123 - </div>
124 - </div>
125 - );
126 -}
127 -
128 -function PlatformVisual() {
129 - return (
130 - <div
131 - className="absolute inset-x-5 -bottom-3 rounded-[12px] border border-fd-border bg-fd-card p-3 font-mono text-[11.5px] leading-[1.75] text-fd-foreground/75 sm:inset-x-6"
132 - style={MOCK_FADE_STYLE}
133 - >
134 - <div className="mb-2 flex items-center gap-1.5">
135 - <span className="size-2 rounded-full bg-fd-foreground/15" />
136 - <span className="size-2 rounded-full bg-fd-foreground/15" />
137 - <span className="size-2 rounded-full bg-fd-foreground/15" />
138 - </div>
139 - <div className="truncate">
140 - <span className="text-[var(--composio-brand)]">import</span>
141 - {" { Composio } "}
142 - <span className="text-[var(--composio-brand)]">from</span>
143 - <span className="text-fd-foreground/55">{" '@composio/core'"}</span>
144 - </div>
145 - <div className="truncate">
146 - <span className="text-[var(--composio-brand)]">import</span>
147 - {" { OpenAIAgentsProvider } "}
148 - <span className="text-[var(--composio-brand)]">from</span>
149 - <span className="text-fd-foreground/55">
150 - {" '@composio/openai-agents'"}
151 - </span>
152 - </div>
153 - <div className="truncate">
154 - <span className="text-[var(--composio-brand)]">const</span>
155 - {' composio = '}
156 - <span className="text-[var(--composio-brand)]">new</span>
157 - {' Composio'}
158 - <span className="text-fd-foreground/45">
159 - ({'{ provider: '}
160 - <span className="text-[var(--composio-brand)]">new</span>
161 - {' OpenAIAgentsProvider() }'})
162 - </span>
163 - </div>
164 - <div className="truncate">
165 - <span className="text-[var(--composio-brand)]">const</span>
166 - {' session = '}
167 - <span className="text-[var(--composio-brand)]">await</span>
168 - {' composio.create'}
169 - <span className="text-fd-foreground/45">(userId)</span>
170 - </div>
171 - <div className="truncate">
172 - <span className="text-[var(--composio-brand)]">const</span>
173 - {' tools = '}
174 - <span className="text-[var(--composio-brand)]">await</span>
175 - {' session.tools'}
176 - <span className="text-fd-foreground/45">()</span>
177 - </div>
178 - <div className="truncate">
179 - <span className="text-[var(--composio-brand)]">const</span>
180 - {' agent = '}
181 - <span className="text-[var(--composio-brand)]">new</span>
182 - {' Agent'}
183 - <span className="text-fd-foreground/45">({'{ name, instructions, model, tools }'})</span>
184 - </div>
185 - </div>
186 - );
187 -}
docs/content/docs/agent-setup/clients.mdx new
+187
@@ -0,0 +1,187 @@
1 +---
2 +title: Clients
3 +description: Install the Composio Agent Skill in popular coding agents
4 +keywords: [clients, agent skill, claude code, codex, cursor, copilot, gemini, openclaw, opencode, cline, grok]
5 +---
6 +
7 +Install the Composio Agent Skill in the coding agent you use to build your application. A project install keeps the skill with one codebase. A global install makes it available in every project you open with that agent.
8 +
9 +## Claude Code
10 +
11 +Claude Code loads project skills from `.claude/skills/` and global skills from `~/.claude/skills/`. Run one of these commands from your project directory:
12 +
13 +**Global install**
14 +
15 +```bash
16 +npx skills add ComposioHQ/composio --skill composio --agent claude-code --global
17 +```
18 +
19 +**Project install**
20 +
21 +```bash
22 +npx skills add ComposioHQ/composio --skill composio --agent claude-code
23 +```
24 +
25 +The Skills CLI installs the skill in Claude Code's skill directory. Start a new Claude Code session if the current session does not discover it, then ask Claude to add Composio to your project.
26 +
27 +<AgentFirstPrompt />
28 +
29 +## OpenCode
30 +
31 +OpenCode loads project skills from `.agents/skills/` and global skills from `~/.config/opencode/skills/`. Run one of these commands from your project directory:
32 +
33 +**Global install**
34 +
35 +```bash
36 +npx skills add ComposioHQ/composio --skill composio --agent opencode --global
37 +```
38 +
39 +**Project install**
40 +
41 +```bash
42 +npx skills add ComposioHQ/composio --skill composio --agent opencode
43 +```
44 +
45 +Start a new OpenCode session after installation so it can discover the skill, then ask OpenCode to add Composio to your project.
46 +
47 +<AgentFirstPrompt />
48 +
49 +## Cline
50 +
51 +Cline loads project skills from `.agents/skills/` and global skills from `~/.agents/skills/`. Run one of these commands from your project directory:
52 +
53 +**Global install**
54 +
55 +```bash
56 +npx skills add ComposioHQ/composio --skill composio --agent cline --global
57 +```
58 +
59 +**Project install**
60 +
61 +```bash
62 +npx skills add ComposioHQ/composio --skill composio --agent cline
63 +```
64 +
65 +Open the project in Cline after installation. Start a new task if the skill is not available in an existing one, then ask Cline to add Composio to the application.
66 +
67 +<AgentFirstPrompt />
68 +
69 +## Grok Build
70 +
71 +Grok Build loads project skills from `.grok/skills/` and global skills from `~/.grok/skills/`. Run one of these commands from your project directory:
72 +
73 +**Global install**
74 +
75 +```bash
76 +npx skills add ComposioHQ/composio --skill composio --agent grok --global
77 +```
78 +
79 +**Project install**
80 +
81 +```bash
82 +npx skills add ComposioHQ/composio --skill composio --agent grok
83 +```
84 +
85 +Start a new Grok Build session after installation so it can discover the skill, then ask it to add Composio and make your first tool call.
86 +
87 +<AgentFirstPrompt />
88 +
89 +## OpenAI Codex
90 +
91 +Codex loads project skills from `.agents/skills/` and global skills from `~/.codex/skills/`. Run one of these commands from your project directory:
92 +
93 +**Global install**
94 +
95 +```bash
96 +npx skills add ComposioHQ/composio --skill composio --agent codex --global
97 +```
98 +
99 +**Project install**
100 +
101 +```bash
102 +npx skills add ComposioHQ/composio --skill composio --agent codex
103 +```
104 +
105 +The project install uses the shared Agent Skills directory, so the skill can travel with the repository. Start a new Codex session after installation, then ask Codex to add Composio to your project.
106 +
107 +<AgentFirstPrompt />
108 +
109 +## Cursor
110 +
111 +Cursor loads project skills from `.agents/skills/` and global skills from `~/.cursor/skills/`. Run one of these commands from your project directory:
112 +
113 +**Global install**
114 +
115 +```bash
116 +npx skills add ComposioHQ/composio --skill composio --agent cursor --global
117 +```
118 +
119 +**Project install**
120 +
121 +```bash
122 +npx skills add ComposioHQ/composio --skill composio --agent cursor
123 +```
124 +
125 +Open the project in Cursor after installation. Start a new agent conversation if the skill is not available in an existing one, then ask Cursor to add Composio to the application.
126 +
127 +<AgentFirstPrompt />
128 +
129 +## GitHub Copilot
130 +
131 +GitHub Copilot loads project skills from `.agents/skills/` and global skills from `~/.copilot/skills/`. Run one of these commands from your repository root:
132 +
133 +**Global install**
134 +
135 +```bash
136 +npx skills add ComposioHQ/composio --skill composio --agent github-copilot --global
137 +```
138 +
139 +**Project install**
140 +
141 +```bash
142 +npx skills add ComposioHQ/composio --skill composio --agent github-copilot
143 +```
144 +
145 +Reopen the repository in VS Code if Copilot does not discover the skill immediately. Use Copilot agent mode and ask it to add Composio to the application.
146 +
147 +<AgentFirstPrompt />
148 +
149 +## Gemini CLI
150 +
151 +Gemini CLI loads project skills from `.agents/skills/` and global skills from `~/.gemini/skills/`. Run one of these commands from your project directory:
152 +
153 +**Global install**
154 +
155 +```bash
156 +npx skills add ComposioHQ/composio --skill composio --agent gemini-cli --global
157 +```
158 +
159 +**Project install**
160 +
161 +```bash
162 +npx skills add ComposioHQ/composio --skill composio --agent gemini-cli
163 +```
164 +
165 +Start a new Gemini CLI session in the project after installation. Mention Composio in your request so Gemini can load the skill and apply its setup guidance.
166 +
167 +<AgentFirstPrompt />
168 +
169 +## OpenClaw
170 +
171 +OpenClaw loads project skills from `skills/` and global skills from `~/.openclaw/skills/`. Run one of these commands from your project directory:
172 +
173 +**Global install**
174 +
175 +```bash
176 +npx skills add ComposioHQ/composio --skill composio --agent openclaw --global
177 +```
178 +
179 +**Project install**
180 +
181 +```bash
182 +npx skills add ComposioHQ/composio --skill composio --agent openclaw
183 +```
184 +
185 +Start a new OpenClaw session after installation so it can discover the skill. OpenClaw loads the relevant skill when your request calls for Composio guidance.
186 +
187 +<AgentFirstPrompt />
docs/content/docs/agent-setup/index.mdx new
+25
@@ -0,0 +1,25 @@
1 +---
2 +title: Overview
3 +description: Set up your coding agent to build with Composio Platform
4 +keywords: [agent setup, agent skill, claude code, codex, cursor, copilot, gemini, openclaw, opencode, cline, grok]
5 +---
6 +
7 +Install the Composio Agent Skill so your coding agent can understand your project and follow the current Platform integration path.
8 +
9 +<AgentSetupGrid />
10 +
11 +## Install the skill
12 +
13 +Run the Skills CLI from your project directory:
14 +
15 +```bash
16 +npx skills add ComposioHQ/composio --skill composio
17 +```
18 +
19 +Choose your coding agent when prompted. See [Clients](/docs/agent-setup/clients) for instructions for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenClaw, OpenCode, Cline, and Grok Build.
20 +
21 +After installation, ask your agent to add Composio. It should inspect your framework, agent architecture, authentication, and user identity model before recommending an integration.
22 +
23 +## Build Composio into an application
24 +
25 +When you are building an application whose users connect their own accounts, use Composio Platform. Start with the [SDK quickstart](/docs/quickstart) after installing the skill.
docs/content/docs/agent-setup/meta.json new
+8
@@ -0,0 +1,8 @@
1 +{
2 + "title": "Agent setup",
3 + "pages": [
4 + "index",
5 + "clients",
6 + "external:[llms.txt](/llms.txt)"
7 + ]
8 +}
docs/content/docs/meta.json
+1
@@ -7,6 +7,7 @@
7 "agent-plugins",
8 "cli",
9 "composio-connect",
10 + "agent-setup",
11 "---Core concepts---",
12 "how-composio-works",
13 "configuring-sessions",
docs/content/docs/quickstart.mdx
+2
@@ -8,6 +8,8 @@ Build an agent that chooses Composio tools at runtime. Type a task, connect an a
8
9 Pick your framework below. A Composio [session](/docs/how-composio-works) gives your agent tool discovery, account connections, and execution across [1000+ apps](/toolkits). It exposes only a small set of meta tools, so app schemas are loaded when the agent needs them.
10
11 +<AgentSetupActions className="not-prose my-6" />
12 +
13 <Callout type="info">
14 The TypeScript SDK is ESM-only and requires Node.js 22.22.3 or newer. Use `import` syntax rather than CommonJS `require()`.
15 </Callout>
docs/lib/home-navigation.ts
+4 -2
@@ -83,7 +83,7 @@ export const DOCS_PRODUCTS = {
83 home: {
84 id: 'use',
85 title: 'Use Composio',
86 - description: 'Use Composio from the agents you already have — Claude Code, Codex, Cursor, or your terminal.',
86 + description: 'Use Composio yourself with agents you already have.',
87 links: [
88 {
89 title: 'Agent plugins',
@@ -111,6 +111,7 @@ export const DOCS_PRODUCTS = {
111 theme: 'dark',
112 themeColor: '#131211',
113 routePrefixes: [
114 + '/docs/agent-setup',
115 '/docs/quickstart',
116 '/docs/providers',
117 '/docs/how-composio-works',
@@ -132,6 +133,7 @@ export const DOCS_PRODUCTS = {
133 {
134 label: 'Get started',
135 items: [
136 + { type: 'folder', path: 'agent-setup' },
137 { type: 'page', url: '/docs/quickstart' },
138 { type: 'folder', path: 'providers', label: 'SDKs and frameworks' },
139 ],
@@ -169,7 +171,7 @@ export const DOCS_PRODUCTS = {
171 home: {
172 id: 'build',
173 title: 'Build with Composio',
172 - description: 'Build Composio into your own agent or application — tools, auth, and triggers for every one of your users.',
174 + description: 'Add Composio into your agent or app.',
175 links: [
176 {
177 title: 'Quickstart',
docs/mdx-components.tsx
+6
@@ -23,6 +23,9 @@ import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
23 import { ManagedAuthList } from '@/components/toolkits/managed-auth-list';
24 import { Mermaid } from '@/components/mermaid';
25 import { AIToolsBanner } from '@/components/ai-tools-banner';
26 +import { AgentFirstPrompt } from '@/components/agent-first-prompt';
27 +import { AgentSetupActions } from '@/components/agent-setup-actions';
28 +import { AgentSetupGrid } from '@/components/agent-setup-grid';
29 import { DocsHero } from '@/components/docs-hero';
30 import { HomeFeatures } from '@/components/home-features';
31 import { SessionFlow } from '@/components/session-flow';
@@ -130,6 +133,9 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
133 ManagedAuthList,
134 Mermaid,
135 AIToolsBanner,
136 + AgentFirstPrompt,
137 + AgentSetupActions,
138 + AgentSetupGrid,
139 DocsHero,
140 HomeFeatures,
141 SessionFlow,
docs/public/images/clients/opencode.svg new
+5
@@ -0,0 +1,5 @@
1 +<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
2 + <rect width="512" height="512" fill="#131010"/>
3 + <path d="M320 224V352H192V224H320Z" fill="#5A5858"/>
4 + <path fill-rule="evenodd" clip-rule="evenodd" d="M384 416H128V96H384V416ZM320 160H192V352H320V160Z" fill="white"/>
5 +</svg>
docs/tests/static/home-navigation.test.ts
+103 -9
@@ -58,13 +58,11 @@ describe('Welcome navigation', () => {
58 expect(homeIntentAnchor(intent.product)).toMatch(/^[a-z0-9-]+$/);
59 }
60 expect(source).toContain('id={homeIntentAnchor(intent.product)}');
61 - // Each card is headed by the canonical product lockup — Composio logo
62 - // plus the dashboard's ComposioProductBadge port — and leads with the
63 - // same mock the dashboard onboarding path step uses for that product: an
64 - // agent chat composer plus client logos for For You, the SDK in a code
65 - // window for Platform.
61 + // Each compact card is headed by the canonical product lockup: Composio
62 + // logo plus the dashboard's ComposioProductBadge port.
63 expect(source).toContain('ProductLockup');
64 expect(source).toContain('ProductSelectionLink');
65 + expect(source).toContain('md:grid-cols-2');
66 expect(lockupSource).toContain('ProductBadge');
67 expect(lockupSource).toContain('background: PLATFORM_BADGE_GRADIENT');
68 expect(lockupSource).toContain("backgroundClip: 'text'");
@@ -77,15 +75,111 @@ describe('Welcome navigation', () => {
75 // swap them in CSS, so an aria-hidden dark variant would drop "Composio"
76 // from the heading's accessible name in dark mode only.
77 expect(lockupSource.match(/alt="Composio"/g) ?? []).toHaveLength(2);
80 - expect(source).toContain('INTENT_VISUALS');
81 - expect(source).toContain('How can I help?');
82 - expect(source).toContain('composio.create');
83 - for (const logo of ['claude.svg', 'codex.png', 'cursor.svg', 'openclaw.svg']) {
78 + });
79 +
80 + test('offers reusable agent setup actions on the homepage and quickstart', async () => {
81 + const source = await Bun.file(
82 + new URL('../../components/agent-setup-actions.tsx', import.meta.url)
83 + ).text();
84 + const heroSource = await Bun.file(
85 + new URL('../../components/docs-hero-v2.tsx', import.meta.url)
86 + ).text();
87 + const quickstartSource = await Bun.file(
88 + new URL('../../content/docs/quickstart.mdx', import.meta.url)
89 + ).text();
90 +
91 + expect(source).toContain('export function AgentSetupActions');
92 + expect(source).toContain('Agent setup');
93 + expect(source).toContain('/docs/agent-setup');
94 + expect(source).not.toContain('ProductSelectionLink');
95 + expect(source).toContain('navigator.clipboard.writeText(SETUP_PROMPT)');
96 + expect(source).toContain('npx skills add ComposioHQ/composio --skill composio');
97 + expect(source).toContain('https://docs.composio.dev');
98 + expect(heroSource).toContain('<AgentSetupActions />');
99 + expect(quickstartSource).toContain('<AgentSetupActions');
100 + for (const logo of ['claude.svg', 'codex.png', 'cursor.svg']) {
101 expect(source).toContain(`/images/clients/${logo}`);
102 expect(await Bun.file(new URL(`../../public/images/clients/${logo}`, import.meta.url)).exists()).toBe(true);
103 }
104 });
105
106 + test('links every agent setup card to instructions on the Clients page', async () => {
107 + const grid = await Bun.file(
108 + new URL('../../components/agent-setup-grid.tsx', import.meta.url)
109 + ).text();
110 + const clients = await Bun.file(
111 + new URL('../../content/docs/agent-setup/clients.mdx', import.meta.url)
112 + ).text();
113 + const agents = [
114 + 'claude-code',
115 + 'openai-codex',
116 + 'cursor',
117 + 'github-copilot',
118 + 'gemini-cli',
119 + 'openclaw',
120 + 'opencode',
121 + 'cline',
122 + 'grok-build',
123 + ];
124 +
125 + for (const agent of agents) {
126 + expect(grid).toContain(`href: '/docs/agent-setup/clients#${agent}'`);
127 + }
128 + const overview = await Bun.file(
129 + new URL('../../content/docs/agent-setup/index.mdx', import.meta.url)
130 + ).text();
131 + expect(overview).toContain('<AgentSetupGrid />');
132 + expect(clients).not.toContain('<AgentSetupGrid');
133 + expect(clients).toContain('title: Clients');
134 + expect(clients.match(/\*\*Global install\*\*/g) ?? []).toHaveLength(9);
135 + expect(clients.match(/\*\*Project install\*\*/g) ?? []).toHaveLength(9);
136 + expect(clients.match(/```bash/g) ?? []).toHaveLength(18);
137 + expect(clients.match(/<AgentFirstPrompt \/>/g) ?? []).toHaveLength(9);
138 + for (const agent of [
139 + 'claude-code',
140 + 'codex',
141 + 'cursor',
142 + 'github-copilot',
143 + 'gemini-cli',
144 + 'openclaw',
145 + 'opencode',
146 + 'cline',
147 + 'grok',
148 + ]) {
149 + expect(clients).toContain(`--agent ${agent} --global`);
150 + expect(clients).toContain(`--agent ${agent}\n`);
151 + }
152 + for (const path of [
153 + '.claude/skills/',
154 + '~/.claude/skills/',
155 + '~/.codex/skills/',
156 + '~/.cursor/skills/',
157 + '~/.copilot/skills/',
158 + '~/.gemini/skills/',
159 + '~/.openclaw/skills/',
160 + '~/.config/opencode/skills/',
161 + '~/.agents/skills/',
162 + '.grok/skills/',
163 + '~/.grok/skills/',
164 + ]) {
165 + expect(clients).toContain(path);
166 + }
167 + for (const logo of ['opencode.svg', 'cline.svg', 'grok.svg']) {
168 + expect(grid).toContain(`/images/clients/${logo}`);
169 + expect(await Bun.file(new URL(`../../public/images/clients/${logo}`, import.meta.url)).exists()).toBe(true);
170 + }
171 + expect(clients).not.toContain('Use Composio with your own apps');
172 + expect(clients).not.toContain('personal apps');
173 +
174 + const firstPrompt = await Bun.file(
175 + new URL('../../components/agent-first-prompt.tsx', import.meta.url)
176 + ).text();
177 + expect(firstPrompt).toContain('navigator.clipboard.writeText(FIRST_PROMPT)');
178 + expect(firstPrompt).toContain('Use the $composio skill to get Composio working in this codebase.');
179 + expect(firstPrompt).toContain('Help me connect an integration and make my first real tool call.');
180 + expect(firstPrompt).toContain('When it works, show me what changed and what I can try next.');
181 + });
182 +
183 test('advertises only toolkits that exist in the catalog', async () => {
184 const source = await Bun.file(
185 new URL('../../components/home-features.tsx', import.meta.url)
docs/tests/static/navigation.test.ts
+8 -2
@@ -17,6 +17,11 @@ function isSeparator(entry: string): boolean {
17 return entry.startsWith("---");
18 }
19
20 +/** Link entries are rendered directly by fumadocs and do not resolve locally. */
21 +function isLink(entry: string): boolean {
22 + return /^(?:external:)?(?:\[[^\]]+\])?\[[^\]]+\]\([^)]+\)$/.test(entry);
23 +}
24 +
25 /** Recursively find all meta.json files under a directory */
26 async function findMetaFiles(dir: string): Promise<string[]> {
27 const results: string[] = [];
@@ -65,6 +70,7 @@ describe("Navigation - meta.json validity", () => {
70 "agent-plugins",
71 "cli",
72 "composio-connect",
73 + "agent-setup",
74 ]);
75
76 expect(
@@ -104,7 +110,7 @@ describe("Navigation - meta.json validity", () => {
110 const missing: string[] = [];
111
112 for (const entry of meta.pages as string[]) {
107 - if (isSeparator(entry)) continue;
113 + if (isSeparator(entry) || isLink(entry)) continue;
114 if (entry === "...") continue;
115
116 const asFile = join(CONTENT_DIR, `${entry}.mdx`);
@@ -131,7 +137,7 @@ describe("Navigation - meta.json validity", () => {
137 const relDir = relative(CONTENT_DIR, dir);
138
139 for (const entry of (meta.pages || []) as string[]) {
134 - if (isSeparator(entry)) continue;
140 + if (isSeparator(entry) || isLink(entry)) continue;
141
142 // Handle "..." (rest) entries which are valid fumadocs syntax
143 if (entry === "...") continue;
docs/tests/static/product-navigation.test.ts
+16
@@ -33,6 +33,7 @@ describe('Docs product navigation', () => {
33 });
34
35 test('classifies audience routes while leaving shared routes unclassified', () => {
36 + expect(classifyDocsProduct('/docs/agent-setup')).toBe('platform');
37 expect(classifyDocsProduct('/docs/agent-plugins')).toBe('for-you');
38 expect(classifyDocsProduct('/docs/composio-connect')).toBe('for-you');
39 expect(classifyDocsProduct('/docs/providers/openai')).toBe('platform');
@@ -122,6 +123,21 @@ describe('Docs product navigation', () => {
123 expect(platformUrls).toContain(url);
124 }
125 expect(platformUrls).not.toContain('/docs/agent-plugins');
126 + expect(platformUrls).toContain('/docs/agent-setup');
127 +
128 + const agentSetup = platformTree.children.find(
129 + node => node.type === 'folder' && node.$ref?.folder === 'agent-setup',
130 + );
131 + expect(agentSetup?.type).toBe('folder');
132 + if (agentSetup?.type !== 'folder') throw new Error('Agent setup folder is missing');
133 + expect(agentSetup.children).toContainEqual(
134 + expect.objectContaining({
135 + type: 'page',
136 + name: 'llms.txt',
137 + url: '/llms.txt',
138 + external: true,
139 + }),
140 + );
141
142 expect(forYouUrls).not.toContain('/docs');
143 expect(platformUrls).not.toContain('/docs');
docs/tests/static/start-routing.test.ts
+12
@@ -86,6 +86,13 @@ describe('getting-started routing policy', () => {
86 }
87 });
88
89 + test('does not turn external sidebar links into documentation URLs', async () => {
90 + const { GET } = await import('../../app/llms.txt/route');
91 + const llms = await (await GET()).text();
92 +
93 + expect(llms).not.toContain('- https://docs.composio.dev/llms.txt.md');
94 + });
95 +
96 /**
97 * `nearest` is the closest preceding heading of any level. Markdown headings
98 * do not close, so it is what an agent reads a URL as belonging to: a page
@@ -141,6 +148,11 @@ describe('getting-started routing policy', () => {
148 });
149 }
150
151 + expect(sectionOf('/docs/agent-setup')).toEqual({
152 + section: '## Get Started',
153 + nearest: '### Agent setup',
154 + });
155 +
156 expect(lines).not.toContain('## Authentication guides');
157 });
158 });