agentsys 5.3.7 → 5.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agnix.toml +17 -7
- package/.claude-plugin/marketplace.json +13 -2
- package/.claude-plugin/plugin.json +1 -1
- package/.gitmodules +3 -0
- package/AGENTS.md +4 -4
- package/CHANGELOG.md +37 -0
- package/README.md +46 -5
- package/lib/adapter-transforms.js +3 -1
- package/package.json +1 -1
- package/site/assets/css/main.css +39 -1
- package/site/assets/js/main.js +24 -0
- package/site/content.json +4 -4
- package/site/index.html +82 -7
- package/site/ux-spec.md +5 -5
- package/agent-knowledge/AGENTS.md +0 -231
- package/agent-knowledge/acp-with-codex-gemini-copilot-claude.md +0 -504
- package/agent-knowledge/ai-cli-advanced-integration-patterns.md +0 -670
- package/agent-knowledge/ai-cli-non-interactive-programmatic-usage.md +0 -1394
- package/agent-knowledge/all-in-one-plus-modular-packages.md +0 -576
- package/agent-knowledge/cli-browser-automation-agents.md +0 -936
- package/agent-knowledge/github-org-project-management.md +0 -319
- package/agent-knowledge/github-org-structure-patterns.md +0 -268
- package/agent-knowledge/kiro-supervised-autopilot.md +0 -400
- package/agent-knowledge/multi-product-org-docs.md +0 -622
- package/agent-knowledge/oss-org-naming-patterns.md +0 -368
- package/agent-knowledge/resources/acp-with-codex-gemini-copilot-claude-sources.json +0 -408
- package/agent-knowledge/resources/ai-cli-non-interactive-programmatic-usage-sources.json +0 -500
- package/agent-knowledge/resources/all-in-one-plus-modular-packages-sources.json +0 -310
- package/agent-knowledge/resources/cli-browser-automation-agents-sources.json +0 -428
- package/agent-knowledge/resources/github-org-project-management-sources.json +0 -239
- package/agent-knowledge/resources/github-org-structure-patterns-sources.json +0 -293
- package/agent-knowledge/resources/kiro-supervised-autopilot-sources.json +0 -135
- package/agent-knowledge/resources/multi-product-org-docs-sources.json +0 -514
- package/agent-knowledge/resources/oss-org-naming-patterns-sources.json +0 -458
- package/agent-knowledge/resources/skill-plugin-distribution-patterns-sources.json +0 -290
- package/agent-knowledge/resources/terminal-browsers-agent-automation-sources.json +0 -758
- package/agent-knowledge/resources/web-session-persistence-cli-agents-sources.json +0 -528
- package/agent-knowledge/skill-plugin-distribution-patterns.md +0 -661
- package/agent-knowledge/terminal-browsers-agent-automation.md +0 -776
- package/agent-knowledge/web-session-persistence-cli-agents.md +0 -1352
|
@@ -1,500 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"topic": "Programmatic & Non-Interactive Usage of AI CLI Tools (Claude Code, Codex CLI, OpenCode, Gemini CLI)",
|
|
3
|
-
"slug": "ai-cli-non-interactive-programmatic-usage",
|
|
4
|
-
"generated": "2026-02-10T00:00:00Z",
|
|
5
|
-
"depth": "deep",
|
|
6
|
-
"totalSources": 42,
|
|
7
|
-
"sources": [
|
|
8
|
-
{
|
|
9
|
-
"url": "https://code.claude.com/docs/en/cli-reference",
|
|
10
|
-
"title": "Claude Code CLI Reference - Complete Flag Reference",
|
|
11
|
-
"qualityScore": 98,
|
|
12
|
-
"scores": { "authority": 10, "recency": 10, "depth": 10, "examples": 10, "uniqueness": 8 },
|
|
13
|
-
"keyInsights": [
|
|
14
|
-
"Complete reference for all CLI flags including -p, --output-format, --session-id, --resume, --max-turns, --allowedTools",
|
|
15
|
-
"--json-schema flag enables validated structured output matching a JSON Schema",
|
|
16
|
-
"--agents flag accepts JSON to define custom subagents dynamically",
|
|
17
|
-
"--permission-mode supports plan, acceptEdits, bypassPermissions, dontAsk, delegate",
|
|
18
|
-
"System prompt flags: --system-prompt (replace), --append-system-prompt (append), and file variants"
|
|
19
|
-
]
|
|
20
|
-
},
|
|
21
|
-
{
|
|
22
|
-
"url": "https://code.claude.com/docs/en/headless",
|
|
23
|
-
"title": "Run Claude Code Programmatically - Headless Mode Guide",
|
|
24
|
-
"qualityScore": 97,
|
|
25
|
-
"scores": { "authority": 10, "recency": 10, "depth": 10, "examples": 10, "uniqueness": 7 },
|
|
26
|
-
"keyInsights": [
|
|
27
|
-
"claude -p is the primary entry point for non-interactive usage",
|
|
28
|
-
"Session continuity via --continue and --resume with session ID capture",
|
|
29
|
-
"Structured output with --output-format json and --json-schema",
|
|
30
|
-
"Stream responses with --output-format stream-json --verbose --include-partial-messages",
|
|
31
|
-
"jq integration for parsing JSON output"
|
|
32
|
-
]
|
|
33
|
-
},
|
|
34
|
-
{
|
|
35
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/overview",
|
|
36
|
-
"title": "Claude Agent SDK Overview - Python and TypeScript SDK",
|
|
37
|
-
"qualityScore": 97,
|
|
38
|
-
"scores": { "authority": 10, "recency": 10, "depth": 10, "examples": 10, "uniqueness": 7 },
|
|
39
|
-
"keyInsights": [
|
|
40
|
-
"Full programmatic SDK available in Python (claude-agent-sdk) and TypeScript (@anthropic-ai/claude-agent-sdk)",
|
|
41
|
-
"query() function provides async iterator streaming of messages",
|
|
42
|
-
"Built-in tools: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch",
|
|
43
|
-
"Supports hooks, subagents, MCP servers, permissions, and session management",
|
|
44
|
-
"SDK renamed from Claude Code SDK to Claude Agent SDK"
|
|
45
|
-
]
|
|
46
|
-
},
|
|
47
|
-
{
|
|
48
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/structured-outputs",
|
|
49
|
-
"title": "Agent SDK Structured Outputs - JSON Schema Validation",
|
|
50
|
-
"qualityScore": 96,
|
|
51
|
-
"scores": { "authority": 10, "recency": 10, "depth": 10, "examples": 10, "uniqueness": 6 },
|
|
52
|
-
"keyInsights": [
|
|
53
|
-
"outputFormat option with type: 'json_schema' enables validated structured output",
|
|
54
|
-
"Works with Zod (TypeScript) and Pydantic (Python) for type-safe schemas",
|
|
55
|
-
"Result message contains structured_output field with validated data",
|
|
56
|
-
"Error handling via subtype: 'error_max_structured_output_retries'",
|
|
57
|
-
"Structured output is not available during streaming"
|
|
58
|
-
]
|
|
59
|
-
},
|
|
60
|
-
{
|
|
61
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/sessions",
|
|
62
|
-
"title": "Agent SDK Session Management - Resume and Fork",
|
|
63
|
-
"qualityScore": 95,
|
|
64
|
-
"scores": { "authority": 10, "recency": 10, "depth": 10, "examples": 9, "uniqueness": 6 },
|
|
65
|
-
"keyInsights": [
|
|
66
|
-
"Session ID captured from 'init' subtype message",
|
|
67
|
-
"Resume sessions via resume option with session ID",
|
|
68
|
-
"Fork sessions with forkSession: true to create branches",
|
|
69
|
-
"Forked sessions preserve original, create new branch from resume point",
|
|
70
|
-
"Sessions maintain full conversation history including tool calls"
|
|
71
|
-
]
|
|
72
|
-
},
|
|
73
|
-
{
|
|
74
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/streaming-output",
|
|
75
|
-
"title": "Agent SDK Streaming Output - Real-Time Responses",
|
|
76
|
-
"qualityScore": 93,
|
|
77
|
-
"scores": { "authority": 10, "recency": 10, "depth": 9, "examples": 10, "uniqueness": 4 },
|
|
78
|
-
"keyInsights": [
|
|
79
|
-
"includePartialMessages option enables StreamEvent messages",
|
|
80
|
-
"Event types: message_start, content_block_start, content_block_delta, content_block_stop, message_delta, message_stop",
|
|
81
|
-
"Text streaming via text_delta events, tool streaming via input_json_delta events",
|
|
82
|
-
"Streaming incompatible with extended thinking and structured outputs",
|
|
83
|
-
"StreamEvent wraps raw Claude API events"
|
|
84
|
-
]
|
|
85
|
-
},
|
|
86
|
-
{
|
|
87
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/quickstart",
|
|
88
|
-
"title": "Agent SDK Quickstart - Build Your First Agent",
|
|
89
|
-
"qualityScore": 92,
|
|
90
|
-
"scores": { "authority": 10, "recency": 10, "depth": 8, "examples": 10, "uniqueness": 4 },
|
|
91
|
-
"keyInsights": [
|
|
92
|
-
"query() is the main entry point, returns async iterator",
|
|
93
|
-
"Permission modes: acceptEdits (auto-approve edits), bypassPermissions (skip all), default (needs callback)",
|
|
94
|
-
"Message types: AssistantMessage, ResultMessage, SystemMessage",
|
|
95
|
-
"Tool restriction via allowedTools option",
|
|
96
|
-
"Supports .env file for API key loading"
|
|
97
|
-
]
|
|
98
|
-
},
|
|
99
|
-
{
|
|
100
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/hosting",
|
|
101
|
-
"title": "Agent SDK Hosting - Production Deployment Patterns",
|
|
102
|
-
"qualityScore": 91,
|
|
103
|
-
"scores": { "authority": 10, "recency": 10, "depth": 9, "examples": 7, "uniqueness": 7 },
|
|
104
|
-
"keyInsights": [
|
|
105
|
-
"Four deployment patterns: Ephemeral, Long-Running, Hybrid, Single Container",
|
|
106
|
-
"Resource requirements: 1GiB RAM, 5GiB disk, 1 CPU per instance",
|
|
107
|
-
"Sandbox providers: Modal, Cloudflare, Daytona, E2B, Fly.io, Vercel",
|
|
108
|
-
"Sessions do not timeout; use maxTurns to prevent infinite loops",
|
|
109
|
-
"Dominant cost is tokens, container cost ~5 cents/hour"
|
|
110
|
-
]
|
|
111
|
-
},
|
|
112
|
-
{
|
|
113
|
-
"url": "https://code.claude.com/docs/en/overview",
|
|
114
|
-
"title": "Claude Code Overview - Getting Started",
|
|
115
|
-
"qualityScore": 88,
|
|
116
|
-
"scores": { "authority": 10, "recency": 10, "depth": 7, "examples": 7, "uniqueness": 4 },
|
|
117
|
-
"keyInsights": [
|
|
118
|
-
"Claude Code available in terminal, IDE, desktop app, browser, and web",
|
|
119
|
-
"Pipe patterns: tail -f app.log | claude -p 'alert on anomalies'",
|
|
120
|
-
"CI/CD integration via GitHub Actions and GitLab CI/CD",
|
|
121
|
-
"MCP for connecting to external tools and data sources",
|
|
122
|
-
"Skills system for reusable workflows"
|
|
123
|
-
]
|
|
124
|
-
},
|
|
125
|
-
{
|
|
126
|
-
"url": "https://code.claude.com/docs/en/sub-agents",
|
|
127
|
-
"title": "Claude Code Subagents - Custom AI Agent Teams",
|
|
128
|
-
"qualityScore": 90,
|
|
129
|
-
"scores": { "authority": 10, "recency": 10, "depth": 10, "examples": 8, "uniqueness": 2 },
|
|
130
|
-
"keyInsights": [
|
|
131
|
-
"--agents CLI flag accepts JSON to define custom subagents at runtime",
|
|
132
|
-
"Built-in subagents: Explore (haiku, read-only), Plan (inherit, read-only), General-purpose",
|
|
133
|
-
"Subagents can run foreground (blocking) or background (concurrent)",
|
|
134
|
-
"Resume subagents with full conversation history via agent ID",
|
|
135
|
-
"Persistent memory scopes: user, project, local"
|
|
136
|
-
]
|
|
137
|
-
},
|
|
138
|
-
{
|
|
139
|
-
"url": "https://code.claude.com/docs/en/github-actions",
|
|
140
|
-
"title": "Claude Code GitHub Actions - CI/CD Integration",
|
|
141
|
-
"qualityScore": 90,
|
|
142
|
-
"scores": { "authority": 10, "recency": 10, "depth": 9, "examples": 9, "uniqueness": 3 },
|
|
143
|
-
"keyInsights": [
|
|
144
|
-
"anthropics/claude-code-action@v1 for GitHub Actions workflows",
|
|
145
|
-
"claude_args parameter passes any CLI arguments",
|
|
146
|
-
"Supports @claude mentions in PR/issue comments",
|
|
147
|
-
"Works with Anthropic API, AWS Bedrock, and Google Vertex AI",
|
|
148
|
-
"Cost optimization: set --max-turns, use concurrency controls"
|
|
149
|
-
]
|
|
150
|
-
},
|
|
151
|
-
{
|
|
152
|
-
"url": "https://code.claude.com/docs/en/common-workflows",
|
|
153
|
-
"title": "Claude Code Common Workflows - Practical Patterns",
|
|
154
|
-
"qualityScore": 87,
|
|
155
|
-
"scores": { "authority": 10, "recency": 10, "depth": 8, "examples": 8, "uniqueness": 1 },
|
|
156
|
-
"keyInsights": [
|
|
157
|
-
"claude -p as Unix utility: pipe in, pipe out",
|
|
158
|
-
"Build script integration: npm scripts with claude -p linting",
|
|
159
|
-
"Session management: --continue for recent, --resume for specific, --from-pr for PR-linked",
|
|
160
|
-
"Git worktrees for parallel Claude Code sessions",
|
|
161
|
-
"--permission-mode plan for safe read-only analysis"
|
|
162
|
-
]
|
|
163
|
-
},
|
|
164
|
-
{
|
|
165
|
-
"url": "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/headless.md",
|
|
166
|
-
"title": "Gemini CLI Headless Mode - Complete Guide",
|
|
167
|
-
"qualityScore": 95,
|
|
168
|
-
"scores": { "authority": 10, "recency": 10, "depth": 10, "examples": 10, "uniqueness": 5 },
|
|
169
|
-
"keyInsights": [
|
|
170
|
-
"gemini -p for non-interactive mode, stdin piping supported",
|
|
171
|
-
"Three output formats: text, json (with stats/metadata), stream-json (JSONL events)",
|
|
172
|
-
"Six stream-json event types: init, message, tool_use, tool_result, error, result",
|
|
173
|
-
"JSON response includes stats.models (token counts), stats.tools (execution stats), stats.files",
|
|
174
|
-
"Batch processing pattern: loop over files with gemini -p per file"
|
|
175
|
-
]
|
|
176
|
-
},
|
|
177
|
-
{
|
|
178
|
-
"url": "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md",
|
|
179
|
-
"title": "Gemini CLI Reference - Complete Flag List",
|
|
180
|
-
"qualityScore": 92,
|
|
181
|
-
"scores": { "authority": 10, "recency": 10, "depth": 9, "examples": 7, "uniqueness": 5 },
|
|
182
|
-
"keyInsights": [
|
|
183
|
-
"--prompt (-p) for headless, --prompt-interactive (-i) for execute-then-interactive",
|
|
184
|
-
"--resume for session continuation (latest, index, UUID)",
|
|
185
|
-
"--approval-mode: default, auto_edit, yolo",
|
|
186
|
-
"--sandbox for sandboxed execution",
|
|
187
|
-
"--allowed-tools for pre-approving specific tools"
|
|
188
|
-
]
|
|
189
|
-
},
|
|
190
|
-
{
|
|
191
|
-
"url": "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/session-management.md",
|
|
192
|
-
"title": "Gemini CLI Session Management - Persistence and Resumption",
|
|
193
|
-
"qualityScore": 91,
|
|
194
|
-
"scores": { "authority": 10, "recency": 10, "depth": 9, "examples": 8, "uniqueness": 5 },
|
|
195
|
-
"keyInsights": [
|
|
196
|
-
"Sessions auto-saved with prompts, responses, tool executions, token stats",
|
|
197
|
-
"Sessions stored in ~/.gemini/tmp/<project_hash>/chats/ (project-specific)",
|
|
198
|
-
"Resume by: --resume (latest), --resume 1 (index), --resume UUID",
|
|
199
|
-
"/resume command opens interactive session browser",
|
|
200
|
-
"Retention policies: maxAge and maxCount settings; maxSessionTurns for cost control"
|
|
201
|
-
]
|
|
202
|
-
},
|
|
203
|
-
{
|
|
204
|
-
"url": "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/settings.md",
|
|
205
|
-
"title": "Gemini CLI Settings - Configuration Reference",
|
|
206
|
-
"qualityScore": 85,
|
|
207
|
-
"scores": { "authority": 10, "recency": 10, "depth": 8, "examples": 5, "uniqueness": 3 },
|
|
208
|
-
"keyInsights": [
|
|
209
|
-
"Settings in ~/.gemini/settings.json (user) and .gemini/settings.json (workspace)",
|
|
210
|
-
"model.maxSessionTurns limits conversation turns (-1 = unlimited)",
|
|
211
|
-
"model.compressionThreshold controls context compression trigger",
|
|
212
|
-
"general.defaultApprovalMode sets default approval strategy",
|
|
213
|
-
"output.format can be text or json"
|
|
214
|
-
]
|
|
215
|
-
},
|
|
216
|
-
{
|
|
217
|
-
"url": "https://github.com/google-gemini/gemini-cli",
|
|
218
|
-
"title": "Gemini CLI Repository - Overview",
|
|
219
|
-
"qualityScore": 88,
|
|
220
|
-
"scores": { "authority": 10, "recency": 10, "depth": 7, "examples": 7, "uniqueness": 4 },
|
|
221
|
-
"keyInsights": [
|
|
222
|
-
"-p flag for non-interactive, --output-format json for structured data",
|
|
223
|
-
"--output-format stream-json for newline-delimited JSON events",
|
|
224
|
-
"-m for model selection (gemini-2.5-flash, etc.)",
|
|
225
|
-
"--include-directories for multi-directory context",
|
|
226
|
-
"GitHub Action available for CI/CD workflows"
|
|
227
|
-
]
|
|
228
|
-
},
|
|
229
|
-
{
|
|
230
|
-
"url": "https://github.com/openai/codex/blob/main/codex-cli/README.md",
|
|
231
|
-
"title": "Codex CLI README - Comprehensive Usage Guide",
|
|
232
|
-
"qualityScore": 90,
|
|
233
|
-
"scores": { "authority": 10, "recency": 10, "depth": 9, "examples": 8, "uniqueness": 4 },
|
|
234
|
-
"keyInsights": [
|
|
235
|
-
"-q/--quiet for non-interactive mode, --json for structured output",
|
|
236
|
-
"Three approval modes: suggest (default), auto-edit, full-auto",
|
|
237
|
-
"full-auto: network disabled, confined to working directory",
|
|
238
|
-
"Multi-provider support: OpenAI, Azure, Gemini, Ollama, Mistral, DeepSeek, etc.",
|
|
239
|
-
"CODEX_QUIET_MODE=1 and DEBUG=true environment variables for automation"
|
|
240
|
-
]
|
|
241
|
-
},
|
|
242
|
-
{
|
|
243
|
-
"url": "https://github.com/openai/codex",
|
|
244
|
-
"title": "Codex CLI Repository - OpenAI's CLI Tool",
|
|
245
|
-
"qualityScore": 82,
|
|
246
|
-
"scores": { "authority": 10, "recency": 10, "depth": 6, "examples": 4, "uniqueness": 2 },
|
|
247
|
-
"keyInsights": [
|
|
248
|
-
"Official OpenAI CLI tool for AI-assisted coding",
|
|
249
|
-
"Installation via npm, Homebrew, or binary downloads",
|
|
250
|
-
"Authentication via ChatGPT sign-in or API key",
|
|
251
|
-
"Supports AGENTS.md for project-specific instructions"
|
|
252
|
-
]
|
|
253
|
-
},
|
|
254
|
-
{
|
|
255
|
-
"url": "https://github.com/opencode-ai/opencode",
|
|
256
|
-
"title": "OpenCode Repository - Terminal AI Assistant (Archived)",
|
|
257
|
-
"qualityScore": 80,
|
|
258
|
-
"scores": { "authority": 8, "recency": 6, "depth": 8, "examples": 7, "uniqueness": 3 },
|
|
259
|
-
"keyInsights": [
|
|
260
|
-
"Archived September 2025, successor is 'Crush' by Charm team",
|
|
261
|
-
"-p for non-interactive, -f json for structured output, -q for quiet",
|
|
262
|
-
"All permissions auto-approved in non-interactive mode",
|
|
263
|
-
"SQLite session persistence",
|
|
264
|
-
"Multi-provider support: OpenAI, Anthropic, Google, Bedrock, Groq, Azure, etc."
|
|
265
|
-
]
|
|
266
|
-
},
|
|
267
|
-
{
|
|
268
|
-
"url": "https://github.com/opencode-ai/opencode/blob/main/README.md",
|
|
269
|
-
"title": "OpenCode README - Complete Feature Reference",
|
|
270
|
-
"qualityScore": 82,
|
|
271
|
-
"scores": { "authority": 8, "recency": 6, "depth": 9, "examples": 7, "uniqueness": 2 },
|
|
272
|
-
"keyInsights": [
|
|
273
|
-
"Full CLI flag reference: -p, -f, -q, -d, -c",
|
|
274
|
-
"Configuration in $HOME/.opencode.json or ./.opencode.json",
|
|
275
|
-
"Bubble Tea TUI with Ctrl+A session switching, Ctrl+N new session",
|
|
276
|
-
"Auto-compact at 95% context usage",
|
|
277
|
-
"MCP and LSP integration for tool access"
|
|
278
|
-
]
|
|
279
|
-
},
|
|
280
|
-
{
|
|
281
|
-
"url": "https://github.com/google-gemini/gemini-cli/tree/main/docs/cli",
|
|
282
|
-
"title": "Gemini CLI Documentation Index",
|
|
283
|
-
"qualityScore": 75,
|
|
284
|
-
"scores": { "authority": 10, "recency": 10, "depth": 4, "examples": 2, "uniqueness": 5 },
|
|
285
|
-
"keyInsights": [
|
|
286
|
-
"Documentation organized: headless.md, session-management.md, cli-reference.md, settings.md",
|
|
287
|
-
"Also covers: skills, custom-commands, authentication, token-caching, checkpointing",
|
|
288
|
-
"Tutorials subdirectory available",
|
|
289
|
-
"Sandbox documentation for safe execution"
|
|
290
|
-
]
|
|
291
|
-
},
|
|
292
|
-
{
|
|
293
|
-
"url": "https://code.claude.com/docs/en/overview#pipe-script-and-automate-with-the-cli",
|
|
294
|
-
"title": "Claude Code - Pipe, Script, and Automate Section",
|
|
295
|
-
"qualityScore": 86,
|
|
296
|
-
"scores": { "authority": 10, "recency": 10, "depth": 6, "examples": 8, "uniqueness": 2 },
|
|
297
|
-
"keyInsights": [
|
|
298
|
-
"Unix-style composability: tail -f | claude -p, git diff | claude -p",
|
|
299
|
-
"CI/CD: translate strings, review files, monitor logs",
|
|
300
|
-
"Follows Unix philosophy of piping and composition"
|
|
301
|
-
]
|
|
302
|
-
},
|
|
303
|
-
{
|
|
304
|
-
"url": "https://github.com/anthropics/claude-code",
|
|
305
|
-
"title": "Claude Code GitHub Repository",
|
|
306
|
-
"qualityScore": 78,
|
|
307
|
-
"scores": { "authority": 10, "recency": 10, "depth": 5, "examples": 4, "uniqueness": 2 },
|
|
308
|
-
"keyInsights": [
|
|
309
|
-
"Multiple installation methods: curl, Homebrew, WinGet, npm",
|
|
310
|
-
"Points to official docs at code.claude.com",
|
|
311
|
-
"Available as terminal CLI, VS Code extension, desktop app"
|
|
312
|
-
]
|
|
313
|
-
},
|
|
314
|
-
{
|
|
315
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/quickstart#key-concepts",
|
|
316
|
-
"title": "Agent SDK Key Concepts - Tools and Permissions",
|
|
317
|
-
"qualityScore": 88,
|
|
318
|
-
"scores": { "authority": 10, "recency": 10, "depth": 7, "examples": 8, "uniqueness": 3 },
|
|
319
|
-
"keyInsights": [
|
|
320
|
-
"Tool tiers: Read-only (Read, Glob, Grep), Modify (Read, Edit, Glob), Full (Read, Edit, Bash, Glob, Grep)",
|
|
321
|
-
"Permission modes: acceptEdits, bypassPermissions, default (with canUseTool callback)",
|
|
322
|
-
"Agent loop: query() returns async iterator, handles tool execution automatically"
|
|
323
|
-
]
|
|
324
|
-
},
|
|
325
|
-
{
|
|
326
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/overview#sessions",
|
|
327
|
-
"title": "Agent SDK Sessions Tab - Overview",
|
|
328
|
-
"qualityScore": 90,
|
|
329
|
-
"scores": { "authority": 10, "recency": 10, "depth": 8, "examples": 9, "uniqueness": 2 },
|
|
330
|
-
"keyInsights": [
|
|
331
|
-
"Capture session_id from init message, use resume option to continue",
|
|
332
|
-
"Context maintained across queries: files read, analysis done, conversation history",
|
|
333
|
-
"Fork sessions to explore different approaches from same starting point"
|
|
334
|
-
]
|
|
335
|
-
},
|
|
336
|
-
{
|
|
337
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/overview#hooks",
|
|
338
|
-
"title": "Agent SDK Hooks - Lifecycle Callbacks",
|
|
339
|
-
"qualityScore": 87,
|
|
340
|
-
"scores": { "authority": 10, "recency": 10, "depth": 8, "examples": 8, "uniqueness": 3 },
|
|
341
|
-
"keyInsights": [
|
|
342
|
-
"PreToolUse, PostToolUse, Stop, SessionStart, SessionEnd hooks",
|
|
343
|
-
"Hooks for validation, logging, blocking, transforming agent behavior",
|
|
344
|
-
"Python and TypeScript implementations with HookMatcher"
|
|
345
|
-
]
|
|
346
|
-
},
|
|
347
|
-
{
|
|
348
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/overview#mcp",
|
|
349
|
-
"title": "Agent SDK MCP Integration",
|
|
350
|
-
"qualityScore": 86,
|
|
351
|
-
"scores": { "authority": 10, "recency": 10, "depth": 7, "examples": 8, "uniqueness": 3 },
|
|
352
|
-
"keyInsights": [
|
|
353
|
-
"MCP servers configurable via mcpServers option in SDK",
|
|
354
|
-
"Example: Playwright MCP for browser automation",
|
|
355
|
-
"Connect to databases, browsers, APIs, and custom tools"
|
|
356
|
-
]
|
|
357
|
-
},
|
|
358
|
-
{
|
|
359
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/overview#subagents",
|
|
360
|
-
"title": "Agent SDK Subagents - Task Delegation",
|
|
361
|
-
"qualityScore": 85,
|
|
362
|
-
"scores": { "authority": 10, "recency": 10, "depth": 7, "examples": 8, "uniqueness": 3 },
|
|
363
|
-
"keyInsights": [
|
|
364
|
-
"Define custom agents with AgentDefinition class",
|
|
365
|
-
"Subagents have independent tools, prompts, and model settings",
|
|
366
|
-
"parent_tool_use_id tracks which messages belong to which subagent"
|
|
367
|
-
]
|
|
368
|
-
},
|
|
369
|
-
{
|
|
370
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/overview#permissions",
|
|
371
|
-
"title": "Agent SDK Permissions - Tool Control",
|
|
372
|
-
"qualityScore": 84,
|
|
373
|
-
"scores": { "authority": 10, "recency": 10, "depth": 7, "examples": 7, "uniqueness": 2 },
|
|
374
|
-
"keyInsights": [
|
|
375
|
-
"allowedTools for allowlist, permissionMode for overall policy",
|
|
376
|
-
"bypassPermissions for headless/CI use",
|
|
377
|
-
"Read-only agents: allow only Read, Glob, Grep"
|
|
378
|
-
]
|
|
379
|
-
},
|
|
380
|
-
{
|
|
381
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/overview#compare-agent-sdk-to-cli",
|
|
382
|
-
"title": "Agent SDK vs CLI Comparison",
|
|
383
|
-
"qualityScore": 83,
|
|
384
|
-
"scores": { "authority": 10, "recency": 10, "depth": 6, "examples": 4, "uniqueness": 5 },
|
|
385
|
-
"keyInsights": [
|
|
386
|
-
"CLI best for interactive dev and one-off tasks",
|
|
387
|
-
"SDK best for CI/CD, custom apps, production automation",
|
|
388
|
-
"Same capabilities, different interface",
|
|
389
|
-
"Workflows translate directly between CLI and SDK"
|
|
390
|
-
]
|
|
391
|
-
},
|
|
392
|
-
{
|
|
393
|
-
"url": "https://code.claude.com/docs/en/sub-agents#built-in-subagents",
|
|
394
|
-
"title": "Claude Code Built-in Subagents Reference",
|
|
395
|
-
"qualityScore": 82,
|
|
396
|
-
"scores": { "authority": 10, "recency": 10, "depth": 8, "examples": 6, "uniqueness": 2 },
|
|
397
|
-
"keyInsights": [
|
|
398
|
-
"Explore: Haiku model, read-only, for fast codebase search",
|
|
399
|
-
"Plan: inherit model, read-only, for plan mode research",
|
|
400
|
-
"General-purpose: inherit model, all tools, for complex tasks",
|
|
401
|
-
"Background subagents run concurrently with pre-approved permissions"
|
|
402
|
-
]
|
|
403
|
-
},
|
|
404
|
-
{
|
|
405
|
-
"url": "https://code.claude.com/docs/en/sub-agents#configure-subagents",
|
|
406
|
-
"title": "Claude Code Subagent Configuration",
|
|
407
|
-
"qualityScore": 84,
|
|
408
|
-
"scores": { "authority": 10, "recency": 10, "depth": 9, "examples": 7, "uniqueness": 2 },
|
|
409
|
-
"keyInsights": [
|
|
410
|
-
"Subagent scopes: CLI flag (session), .claude/agents/ (project), ~/.claude/agents/ (user), plugins",
|
|
411
|
-
"YAML frontmatter with name, description, tools, model, permissionMode, hooks, skills, memory",
|
|
412
|
-
"Persistent memory with user/project/local scopes",
|
|
413
|
-
"PreToolUse hooks for conditional validation"
|
|
414
|
-
]
|
|
415
|
-
},
|
|
416
|
-
{
|
|
417
|
-
"url": "https://code.claude.com/docs/en/common-workflows#use-plan-mode-for-safe-code-analysis",
|
|
418
|
-
"title": "Claude Code Plan Mode - Safe Analysis",
|
|
419
|
-
"qualityScore": 80,
|
|
420
|
-
"scores": { "authority": 10, "recency": 10, "depth": 7, "examples": 6, "uniqueness": 3 },
|
|
421
|
-
"keyInsights": [
|
|
422
|
-
"Plan mode: read-only exploration, no modifications",
|
|
423
|
-
"claude --permission-mode plan -p 'analyze the system'",
|
|
424
|
-
"Safe for CI/CD where you only want analysis, not changes"
|
|
425
|
-
]
|
|
426
|
-
},
|
|
427
|
-
{
|
|
428
|
-
"url": "https://code.claude.com/docs/en/common-workflows#control-output-format",
|
|
429
|
-
"title": "Claude Code Output Format Control",
|
|
430
|
-
"qualityScore": 79,
|
|
431
|
-
"scores": { "authority": 10, "recency": 10, "depth": 6, "examples": 7, "uniqueness": 1 },
|
|
432
|
-
"keyInsights": [
|
|
433
|
-
"--output-format text for simple integrations",
|
|
434
|
-
"--output-format json for full conversation log with metadata",
|
|
435
|
-
"--output-format stream-json for real-time processing"
|
|
436
|
-
]
|
|
437
|
-
},
|
|
438
|
-
{
|
|
439
|
-
"url": "https://code.claude.com/docs/en/common-workflows#resume-previous-conversations",
|
|
440
|
-
"title": "Claude Code Session Resumption Patterns",
|
|
441
|
-
"qualityScore": 81,
|
|
442
|
-
"scores": { "authority": 10, "recency": 10, "depth": 7, "examples": 6, "uniqueness": 1 },
|
|
443
|
-
"keyInsights": [
|
|
444
|
-
"--continue for most recent conversation in current directory",
|
|
445
|
-
"--resume for specific session by name or ID",
|
|
446
|
-
"--from-pr for PR-linked sessions",
|
|
447
|
-
"/resume picker with keyboard shortcuts",
|
|
448
|
-
"Session naming with /rename for easy recall"
|
|
449
|
-
]
|
|
450
|
-
},
|
|
451
|
-
{
|
|
452
|
-
"url": "https://code.claude.com/docs/en/github-actions#configuration-examples",
|
|
453
|
-
"title": "Claude Code GitHub Actions Configuration",
|
|
454
|
-
"qualityScore": 84,
|
|
455
|
-
"scores": { "authority": 10, "recency": 10, "depth": 7, "examples": 8, "uniqueness": 2 },
|
|
456
|
-
"keyInsights": [
|
|
457
|
-
"anthropics/claude-code-action@v1 with unified prompt interface",
|
|
458
|
-
"claude_args for CLI passthrough: --max-turns, --model, --mcp-config, --allowed-tools",
|
|
459
|
-
"Supports skills like /review as prompts",
|
|
460
|
-
"Bedrock and Vertex AI authentication via OIDC"
|
|
461
|
-
]
|
|
462
|
-
},
|
|
463
|
-
{
|
|
464
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/hosting#production-deployment-patterns",
|
|
465
|
-
"title": "Agent SDK Production Deployment Patterns",
|
|
466
|
-
"qualityScore": 87,
|
|
467
|
-
"scores": { "authority": 10, "recency": 10, "depth": 8, "examples": 6, "uniqueness": 5 },
|
|
468
|
-
"keyInsights": [
|
|
469
|
-
"Ephemeral: new container per task, destroy when complete",
|
|
470
|
-
"Long-running: persistent instances for proactive agents",
|
|
471
|
-
"Hybrid: ephemeral with session resumption for intermittent interaction",
|
|
472
|
-
"Single container: multiple SDK processes for agent collaboration"
|
|
473
|
-
]
|
|
474
|
-
},
|
|
475
|
-
{
|
|
476
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/streaming-output#build-a-streaming-ui",
|
|
477
|
-
"title": "Agent SDK Streaming UI Pattern",
|
|
478
|
-
"qualityScore": 83,
|
|
479
|
-
"scores": { "authority": 10, "recency": 10, "depth": 8, "examples": 9, "uniqueness": 3 },
|
|
480
|
-
"keyInsights": [
|
|
481
|
-
"Track in_tool flag to show status indicators during tool execution",
|
|
482
|
-
"content_block_start/delta/stop for tool call tracking",
|
|
483
|
-
"text_delta events for real-time text display",
|
|
484
|
-
"Combine text and tool streaming for cohesive UI"
|
|
485
|
-
]
|
|
486
|
-
},
|
|
487
|
-
{
|
|
488
|
-
"url": "https://platform.claude.com/docs/en/agent-sdk/sessions#forking-sessions",
|
|
489
|
-
"title": "Agent SDK Session Forking - Branch Conversations",
|
|
490
|
-
"qualityScore": 84,
|
|
491
|
-
"scores": { "authority": 10, "recency": 10, "depth": 8, "examples": 8, "uniqueness": 4 },
|
|
492
|
-
"keyInsights": [
|
|
493
|
-
"forkSession: true creates new session from resume point",
|
|
494
|
-
"Original session preserved unchanged",
|
|
495
|
-
"Useful for exploring alternatives, A/B testing approaches",
|
|
496
|
-
"Both forked and original can be resumed independently"
|
|
497
|
-
]
|
|
498
|
-
}
|
|
499
|
-
]
|
|
500
|
-
}
|