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 22, 07:00 UTC
docs: add chat-app to cookbooks index and update plan
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sushmitha Mallesh committed
Feb 23, 2026 at 19:18 UTC
2f39ecb3c8f90abf04667fbeeceaa754a33c034c
2 files changed
+191
docs/.claude/plan.md
new
+190
@@ -0,0 +1,190 @@
1
+# Cookbooks Complete Revamp — Task Tracker
2
+
3
+**Goal:** Transform cookbooks into a use-case-driven section with scannable card overview, concise dual-language examples, problem-first framing, and a Modal-inspired index page. All code uses the `session.create` paradigm exclusively.
4
+
5
+---
6
+
7
+## Phase 1: Foundation & Structure
8
+
9
+### 1.0 Rename Examples → Cookbooks ✅
10
+
11
+- [x] Renamed `content/examples/` → `content/cookbooks/`
12
+- [x] Updated all source configs, routes, nav, search, LLM endpoints, sitemap
13
+- [x] Added `/examples/` → `/cookbooks/` permanent redirects
14
+- PR #2638 (merged)
15
+
16
+### 1.1 Review & Update Provider Pages
17
+
18
+**LLM Guardrails** ✅
19
+
20
+- [x] Session guardrails (default, ~1100+ pages)
21
+- [x] Direct execution guardrails (12 tagged pages)
22
+- [x] Pipeline injection via `getLLMText()`
23
+- [x] `llms-full.txt` and `llms.txt` updated
24
+
25
+**Existing Providers (review & update)** ✅
26
+
27
+- [x] `openai.mdx` — Responses API + Chat Completions
28
+- [x] `anthropic.mdx` — Messages API, Steps pattern
29
+- [x] `google.mdx` — Chat API, Steps pattern
30
+- [x] `vercel.mdx` — Native tools only, Steps pattern
31
+- [x] `langchain.mdx` — PR #2651
32
+- [x] `llamaindex.mdx` — PR #2651
33
+- [x] `mastra.mdx` — PR #2651
34
+- [x] `crewai.mdx` — PR #2651 + PR #2650 (strict mode fix)
35
+- [x] `openai-agents.mdx` — PR #2651
36
+
37
+**New Providers (write from scratch)**
38
+
39
+- [x] `claude-agent-sdk.mdx` — Python + TS (PR #2651)
40
+- [x] `autogen.mdx` — Python only (PR #2651, SDK has broken imports — PLEN-1603)
41
+- [x] `google-adk.mdx` — Python only (PR #2651)
42
+- [ ] `langgraph.mdx` — Python only (not started)
43
+- [x] Providers index page with card grid (PR #2655)
44
+- Cloudflare removed (PLEN-1602 for e2e testing)
45
+
46
+**PRs:**
47
+- #2651 — Providers revamp (merged into next)
48
+- #2655 — Providers index page + reorder
49
+- #2650 — CrewAI strict mode fix
50
+- #2647 — LangChain serialization fix
51
+
52
+**Linear Tickets:**
53
+- PLEN-1602 — Cloudflare e2e testing
54
+- PLEN-1603 — AutoGen broken imports
55
+
56
+### 1.2 Move existing cookbooks to guides/ subfolder — DEFERRED
57
+
58
+- [ ] Move `fast-api`, `hono`, `slack-summariser`, `vercel-chat`, `tool-generator` to `content/cookbooks/guides/`
59
+- [ ] Delete `gmail-labeler.mdx` and `supabase-sql-agent.mdx`
60
+- [ ] Add redirects
61
+- Deferred until after Phase 2
62
+
63
+### 1.3 Rewrite cookbooks meta.json — DEFERRED
64
+
65
+- [ ] New category structure (Code & DevOps, Communication, Sales, Research, etc.)
66
+- Deferred until after Phase 2
67
+
68
+### 1.4 Create "Use Composio With" section — DEFERRED
69
+
70
+- [ ] chatgpt, agent-builder, claude-desktop, claude-code, cursor, vscode, mcp-url, n8n
71
+- Deferred until after Phase 2
72
+
73
+### 1.5 Rewrite cookbooks index page — DEFERRED
74
+
75
+- [ ] Card-grid overview inspired by Modal
76
+- Deferred until after Phase 2
77
+
78
+---
79
+
80
+## Phase 2: Write New Use-Case Cookbooks
81
+
82
+**Template for each cookbook:**
83
+- Title + 1-paragraph description
84
+- What You'll Build (2-3 bullets)
85
+- Prerequisites (API keys, connected accounts)
86
+- Implementation (code in files, imported via include)
87
+- How It Works
88
+- Next Steps
89
+
90
+**Key rules:**
91
+- All code uses `session.create` paradigm exclusively
92
+- No auth boilerplate — link to `/docs/authentication`
93
+- Code lives in `docs/cookbooks/{name}/` directory, imported into MDX via include
94
+- Action-oriented titles
95
+
96
+### Priority 1 (highest impact)
97
+
98
+- [x] `chat-app` — Build a Chat App (PR #2728, branch: `docs/chat-app-1`)
99
+- [ ] `slack-bot` — Build a Slack Bot (Vercel AI SDK + Composio)
100
+- [ ] `pr-review-agent` — Build a PR Review Agent (GitHub)
101
+- [ ] `gmail-auto-labeler` — Build a Gmail Auto-Labeler (Gmail)
102
+- [ ] `slack-summarizer` — Build a Slack Channel Summarizer (Slack)
103
+- [ ] `mcp-setup` — Connect Composio Tools via MCP
104
+- [ ] `research-agent` — Build a Research Agent (Web Search, Scraping)
105
+
106
+### Priority 2
107
+
108
+- [ ] `lead-enrichment` — Build a Lead Enrichment Agent (HubSpot, Web)
109
+- [ ] `email-at-scale` — Send Personalized Emails at Scale (Gmail)
110
+- [ ] `issue-triage` — Auto-Triage GitHub Issues (GitHub)
111
+- [ ] `meeting-notes-to-notion` — Sync Meeting Notes to Notion (Notion)
112
+- [ ] `sheets-sync` — Sync Data to Google Sheets (Google Sheets)
113
+
114
+### Priority 3
115
+
116
+- [ ] `email-trigger-agent` — Run an Agent on New Emails (Gmail, Triggers)
117
+- [ ] `daily-digest` — Daily GitHub Digest to Slack (GitHub, Slack)
118
+- [ ] `calendar-agent` — Create Calendar Events from Natural Language (Google Calendar)
119
+- [ ] `ci-failure-notifier` — Post CI Failures to Discord (GitHub, Discord)
120
+- [ ] `social-posting` — Social Media Content Agent (LinkedIn, Twitter)
121
+- [ ] `voice-agent` — Build a Voice Agent with Tool Calling (Voice, TBD)
122
+
123
+---
124
+
125
+## Phase 3: Write Framework Cookbooks
126
+
127
+Full-stack templates live as cloneable repos on GitHub. Docs pages describe what the template does, show key snippets, and link to the repo.
128
+
129
+### TypeScript Frameworks
130
+
131
+- [ ] `express.mdx`
132
+- [ ] `fastify.mdx`
133
+- [ ] `hono.mdx`
134
+- [ ] `nextjs.mdx`
135
+- [ ] `nestjs.mdx`
136
+- [ ] `nuxt.mdx`
137
+- [ ] `sveltekit.mdx`
138
+- [ ] `node-http.mdx`
139
+
140
+### Python Frameworks
141
+
142
+- [ ] `fastapi.mdx`
143
+- [ ] `flask.mdx`
144
+- [ ] `django.mdx`
145
+
146
+---
147
+
148
+## Phase 4: Polish
149
+
150
+- [ ] Run `bun run build` to validate all TypeScript code blocks
151
+- [ ] Test mobile layout
152
+- [ ] Verify all cross-links work
153
+- [ ] Update `.claude/decisions/examples.md` with status
154
+
155
+---
156
+
157
+## Phase 5: Revamp Cookbooks Index Page
158
+
159
+- [ ] Visual card grid with categories (Modal-inspired)
160
+- [ ] Each card: title, short description, toolkit tags
161
+- [ ] Featured/popular section at top
162
+- [ ] Update incrementally as cookbooks are added
163
+
164
+---
165
+
166
+## Decisions & Notes
167
+
168
+- Code files live at `docs/examples/{cookbook-name}/` (excluded from tsconfig, type-checked by twoslash via `<include>`)
169
+- MDX pages use fumadocs `<include>` component to import code from files
170
+- Cookbooks link to GitHub source: `github.com/ComposioHQ/composio/tree/master/docs/examples/{name}`
171
+- Tools count is now 1000+ (not 250+)
172
+- Phase 1.2–1.5 deferred until after Phase 2 for continuous shipping
173
+- Twoslash JSX fix: added `jsx: ReactJSX` + `jsxImportSource: react` to twoslash compilerOptions in source.config.ts (global fix for all TSX code blocks)
174
+- `examples/` excluded from tsconfig.json (twoslash handles type-checking via `<include>`, Next.js `tsc` can't resolve local relative imports)
175
+- Welcome page revamped: hero cards (Tutorial + How it works), full-width Quickstart, AIToolsBanner component, Explore section
176
+- AIToolsBanner component has markdown fallback in `lib/source.ts` for LLM crawlers
177
+
178
+---
179
+
180
+## Summary
181
+
182
+| Phase | Status |
183
+|-------|--------|
184
+| 1.0 Rename Examples → Cookbooks | ✅ Done |
185
+| 1.1 Provider Pages | ✅ Done (except `langgraph.mdx`) |
186
+| 1.2–1.5 Structure & Index | Deferred |
187
+| 2 Use-Case Cookbooks | In progress (1 done, 17 remaining) |
188
+| 3 Framework Cookbooks | Not started (11 cookbooks) |
189
+| 4 Polish | Not started |
190
+| 5 Index Page Revamp | Not started |
docs/content/cookbooks/index.mdx
+1
@@ -12,6 +12,7 @@ Browse open-source templates or follow step-by-step guides below.
12
## Getting Started
13
14
<Cards>
15
+ <Card title="Build a Chat App" href="/cookbooks/chat-app" description="Next.js chat app with tool discovery across 1000+ apps" />
16
<Card title="Basic FastAPI Server" href="/cookbooks/fast-api" description="Build a Gmail agent with FastAPI" />
17
<Card title="Basic Hono Server" href="/cookbooks/hono" description="Build a Gmail agent with Hono.js" />
18
</Cards>