cloudflare/agents

Build and deploy AI Agents on Cloudflare

Stars: 5.6k
Forks: 726
Open beginner issues: 1
Indexed issues: 146
Avg merge: 1d 17h
Merged PRs (30d): 49

Dominant language: TypeScript
License: MIT
Last GitHub push: Sep 18, 2026
Latest indexed: Sep 15, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

144 open issues indexed

Think: expose the turn's AbortSignal to beforeTurn Open

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

cloudflare/agents#2309 · 1 comment · Opened Sep 21, 2026
codemode: array item unions and intersections generate incorrect TypeScript Open

bug

cloudflare/agents#2308 · 1 assignee · Opened Sep 19, 2026
Legacy runFiber can recover work that already finished Open

Difficulty 3/5 1-2 days Newbie friendliness 74/100

cloudflare/agents#2305 · Opened Sep 18, 2026
MCPClientManager logs a recoverable discovery timeout at console.error Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

cloudflare/agents#2300 · Opened Sep 18, 2026
_syncHostJobs runs on facet instances even though the root owns the alarm Open

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

cloudflare/agents#2299 · Opened Sep 18, 2026
runAgentTool: opt-in terminal-only event delivery so a headless parent does not rebroadcast every child chunk Open

enhancement

cloudflare/agents#2298 · 1 assignee · Opened Sep 18, 2026
codemode: searchConnectors matches unrelated methods through short tokens Open

bug

cloudflare/agents#2296 · 1 assignee · Opened Sep 17, 2026
ChatRecoveryConfig.maxRecoveryWork docs retain old default and omit durable-segment unit Open

documentation

cloudflare/agents#2282 · 1 assignee · Opened Sep 15, 2026
Think: return an authoritative cancellation outcome from cancelSubmission Open

Difficulty 5/5 Over a week Newbie friendliness 38/100

cloudflare/agents#2281 · Opened Sep 15, 2026
Chat terminal/error frames: expose originating user-message and submission identity Open

enhancement

cloudflare/agents#2280 · 1 assignee · Opened Sep 15, 2026
Think: durable conversation Stop spanning submissions, interactions, and recovery Open

enhancement think

cloudflare/agents#2279 · 1 assignee · Opened Sep 15, 2026
Think: opt-in deferred tool discovery for ordinary tool calls across providers Open

enhancement

cloudflare/agents#2277 · 1 assignee · Opened Sep 15, 2026
WebSockets state sync: clients can write state by default; consider a read-only mode Open

enhancement

cloudflare/agents#2269 · 1 assignee · Opened Sep 14, 2026
useAgent ready resolves on the identity frame, before the initial state frame Open

bug

cloudflare/agents#2268 · 1 assignee · Opened Sep 14, 2026
useAgentChat still hits React #185 with a 50ms throttle on agents@0.22.0 Open

bug

cloudflare/agents#2267 · 1 assignee · Opened Sep 14, 2026
Think: `onChatResponse` never fires if the DO resets between persisting the assistant message and running the hook Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

cloudflare/agents#2266 · Opened Sep 13, 2026
Think: no public wait for a submission to finish Open

enhancement

cloudflare/agents#2265 · 1 assignee · Opened Sep 12, 2026
Think: `TurnResult.message` is the session leaf, not the message this turn produced Open

Difficulty 4/5 3-5 days Newbie friendliness 55/100

cloudflare/agents#2264 · Opened Sep 12, 2026
Think: no hook to set AI Gateway id or `cf-aig-metadata` per turn Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

cloudflare/agents#2262 · 1 reaction · Opened Sep 12, 2026
Think: `TurnResult` in wait mode lacks the parsed `output` when `TurnConfig.output` is set Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

cloudflare/agents#2263 · Opened Sep 12, 2026
Think: configureChannels() policy never applies to WebSocket chat turns (ws-chat admits the turn with no channel) Open

Difficulty 4/5 3-5 days Newbie friendliness 64/100

cloudflare/agents#2255 · Opened Sep 12, 2026
Facet broadcasts after the frame completes cost two root RPCs per message (getAgentByName on every broadcast) Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 68/100

cloudflare/agents#2252 · 4 comments · Opened Sep 11, 2026
Support for DeepGram Flux in the voice-deepgram package Open

enhancement

cloudflare/agents#2247 · 1 assignee · Opened Sep 11, 2026
think: runTurn({ mode: "wait" }) resolves with message: undefined when a second turn is queued on the same agent Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

cloudflare/agents#2243 · 1 comment · 1 assignee · Opened Sep 11, 2026
Agent WebSockets have no heartbeat: an idle socket is dropped without a close frame and the client keeps sending into it Open

bug

cloudflare/agents#2242 · 2 comments · 1 assignee · Opened Sep 11, 2026
think: expose the admitted turn's requestId on TurnContext for beforeTurn Open

enhancement

cloudflare/agents#2240 · 1 assignee · Opened Sep 10, 2026
Think: public accessor for the admitted turn's request id and trigger Open

enhancement think

cloudflare/agents#2218 · 1 comment · 1 assignee · Opened Sep 6, 2026
useAgentChat: the clientToolResults cleanup effect dispatches setState once per streamed chunk, accumulating nestedUpdateCount to the React #185 throw Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

cloudflare/agents#2217 · 1 comment · Opened Sep 4, 2026
Avoid installing the legacy MCP SDK when legacy APIs are unused Open

Difficulty 4/5 3-5 days Newbie friendliness 52/100

cloudflare/agents#2209 · Opened Sep 3, 2026
sessions: the change-feed cache mirror is duplicated in every host Open

enhancement

cloudflare/agents#2205 · 1 assignee · Opened Sep 2, 2026
sessions: optional R2 tier for the attachment store Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 30/100

cloudflare/agents#2204 · Opened Sep 2, 2026
Shape tool output at the boundary, the way pi does, instead of only after the fact Open

enhancement think

Difficulty 5/5 Over a week Newbie friendliness 38/100

cloudflare/agents#2201 · Opened Sep 2, 2026
Investigate which context-reduction mechanisms break prompt caching Open

enhancement think

cloudflare/agents#2200 · 1 assignee · Opened Sep 2, 2026
useAgentChat: onToolCall fires for server-side tools, and answering one sends the server a false failure verdict Open

bug

cloudflare/agents#2195 · 1 assignee · Opened Sep 1, 2026
Auto-continuation parks forever when an approval tool shares an assistant message with an already-settled tool Open

bug

cloudflare/agents#2185 · 1 assignee · Opened Aug 30, 2026
codemode: jsonSchemaToType drops sibling properties on root $ref and types allOf refinements as unknown Open

bug

cloudflare/agents#2181 · 1 comment · 1 assignee · Opened Aug 29, 2026
AIChatAgent re-arms stale tool auto-continuation after active stream finishes with stop Open

Difficulty 3/5 1-2 days Newbie friendliness 38/100

cloudflare/agents#2171 · 1 comment · 1 reaction · Opened Aug 27, 2026
useAgentChat: recovered/resumed reply interleaves into scrambled text and never self-heals (clean server snapshot is discarded) Open

Difficulty 4/5 3-5 days Newbie friendliness 64/100

cloudflare/agents#2166 · Opened Aug 26, 2026
think: false-positive warning "getSystemPrompt() is only used as a fallback…" fires when skills are configured without overriding getSystemPrompt Open

think

Difficulty 3/5 1-2 days Newbie friendliness 74/100

cloudflare/agents#2165 · 4 comments · Opened Aug 26, 2026
Add an opt-in live web search example to the MCP client Open

enhancement

Difficulty 3/5 1-2 days Newbie friendliness 38/100

cloudflare/agents#2164 · Opened Aug 25, 2026
Investigate speculative programmatic tool calling in Code Mode Open

enhancement

cloudflare/agents#2159 · 1 assignee · Opened Aug 25, 2026
Voice SDK: add native full-duplex provider and AI SDK tool lifecycle Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

cloudflare/agents#2158 · 1 reaction · Opened Aug 24, 2026
Add an agents/retries subpath and standardize retry utilities Open

enhancement

cloudflare/agents#2137 · 1 assignee · Opened Aug 20, 2026
Stateless createMcpHandler: support the MCP Tasks extension (SEP-2663, io.modelcontextprotocol/tasks) Open

enhancement mcp

cloudflare/agents#2135 · 1 comment · 1 assignee · Opened Aug 19, 2026
codemode: support argument-aware approval decisions before durable pause Open

enhancement

cloudflare/agents#2134 · 1 comment · 1 assignee · Opened Aug 19, 2026
No per-turn correlator exposed to beforeToolCall / onChatResponse — cross-hook turn identity cannot be threaded safely Open

think

Difficulty 5/5 Over a week Newbie friendliness 45/100

cloudflare/agents#2127 · Opened Aug 18, 2026
Think sends “done” before saving the final transcript Open

think

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

cloudflare/agents#2119 · 1 comment · Opened Aug 16, 2026
Rejected sub-agent WebSocket connection retries forever, no error surfaced Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

cloudflare/agents#2118 · 4 comments · Opened Aug 16, 2026
Validate McpConnector inputs against advertised schemas before remote calls Open

Difficulty 3/5 1-2 days Newbie friendliness 74/100

cloudflare/agents#2117 · 1 comment · Opened Aug 15, 2026
Think: chat recovery completes an interrupted messenger turn, but the recovered answer is never delivered to the messenger thread Open

bug think

cloudflare/agents#2106 · 1 assignee · Opened Aug 13, 2026

A short digest of beginner-friendly GitHub issues.