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 21, 13:30 UTC
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
});