-
Notifications
You must be signed in to change notification settings - Fork 29
Expand file tree
/
Copy pathindex.html
More file actions
559 lines (524 loc) · 24.9 KB
/
index.html
File metadata and controls
559 lines (524 loc) · 24.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>CortexPilot | Agent starter kits for Codex, Claude Code, and OpenClaw</title>
<meta
name="description"
content="Copy-paste agent starter kits for CortexPilot: truthful read-only MCP setup, repo-owned skills/bootstrap files, and builder-safe entrypoints for Codex, Claude Code, and OpenClaw."
/>
<meta
name="keywords"
content="CortexPilot, Codex MCP, Claude Code MCP, OpenClaw MCP, agent starter kit, read-only MCP, skills, builder integration"
/>
<link rel="canonical" href="https://xiaojiou176-open.github.io/CortexPilot-public/agent-starters/" />
<meta property="og:title" content="CortexPilot | Agent starter kits for Codex, Claude Code, and OpenClaw" />
<meta
property="og:description"
content="Copy-paste read-only MCP and skills/bootstrap starter kits for Codex, Claude Code, and OpenClaw teams adopting CortexPilot truthfully."
/>
<meta property="og:type" content="article" />
<meta property="og:url" content="https://xiaojiou176-open.github.io/CortexPilot-public/agent-starters/" />
<meta property="og:image" content="../assets/storefront/social-preview-1280x640.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="CortexPilot | Agent starter kits for Codex, Claude Code, and OpenClaw" />
<meta
name="twitter:description"
content="Copy-paste read-only MCP and skills/bootstrap starter kits for Codex, Claude Code, and OpenClaw teams adopting CortexPilot truthfully."
/>
<meta name="twitter:image" content="../assets/storefront/social-preview-1280x640.png" />
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "TechArticle",
"headline": "CortexPilot agent starter kits for Codex, Claude Code, and OpenClaw",
"url": "https://xiaojiou176-open.github.io/CortexPilot-public/agent-starters/",
"description": "Copy-paste read-only MCP, skills/bootstrap, and builder-safe starter kits for CortexPilot adoption across Codex, Claude Code, and OpenClaw."
}
</script>
<style>
:root {
color-scheme: light;
--bg: #f4efe8;
--panel: #fffaf4;
--ink: #17232c;
--muted: #52616d;
--line: rgba(23, 35, 44, 0.12);
--accent: #0f766e;
--accent-soft: rgba(15, 118, 110, 0.1);
--accent-alt: #92400e;
--accent-alt-soft: rgba(146, 64, 14, 0.1);
--shadow: 0 24px 60px rgba(23, 35, 44, 0.1);
}
* { box-sizing: border-box; }
body {
margin: 0;
background:
radial-gradient(circle at top left, rgba(15, 118, 110, 0.08), transparent 30%),
radial-gradient(circle at top right, rgba(146, 64, 14, 0.08), transparent 26%),
linear-gradient(180deg, #faf6ef 0%, #f1ece3 100%);
color: var(--ink);
font: 16px/1.65 "Inter", "Segoe UI", system-ui, sans-serif;
}
main {
max-width: 1100px;
margin: 0 auto;
padding: 40px 20px 72px;
}
a { color: var(--accent); }
a:hover { color: #0b5d57; }
.hero,
.section,
.table-shell {
background: var(--panel);
border: 1px solid var(--line);
border-radius: 28px;
box-shadow: var(--shadow);
}
.hero,
.section {
padding: 28px;
}
.section {
margin-top: 24px;
}
.eyebrow,
.badge {
display: inline-flex;
width: fit-content;
padding: 7px 12px;
border-radius: 999px;
font-size: 13px;
font-weight: 700;
}
.eyebrow {
background: rgba(23, 35, 44, 0.08);
color: var(--muted);
}
.badge.primary { background: var(--accent-soft); color: var(--accent); }
.badge.warn { background: var(--accent-alt-soft); color: var(--accent-alt); }
h1, h2, h3 { margin: 0; line-height: 1.15; }
h1 { font-size: clamp(2.4rem, 4vw, 3.9rem); max-width: 11ch; }
h2 { font-size: 1.7rem; margin-bottom: 12px; }
p, li, td { color: var(--muted); }
.lede { font-size: 1.08rem; max-width: 78ch; }
.mini-nav,
.actions {
display: flex;
flex-wrap: wrap;
gap: 12px;
}
.button {
display: inline-flex;
align-items: center;
justify-content: center;
padding: 12px 16px;
border-radius: 999px;
text-decoration: none;
font-weight: 600;
}
.button.primary { background: var(--accent); color: white; }
.button.secondary {
border: 1px solid var(--line);
background: white;
color: var(--ink);
}
.grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
gap: 16px;
}
.card {
border: 1px solid var(--line);
border-radius: 22px;
background: white;
padding: 18px;
}
.table-shell {
margin-top: 24px;
overflow: hidden;
}
table {
width: 100%;
border-collapse: collapse;
}
th, td {
padding: 14px 16px;
border-bottom: 1px solid var(--line);
text-align: left;
vertical-align: top;
}
th {
font-size: 13px;
letter-spacing: 0.03em;
text-transform: uppercase;
background: rgba(23, 35, 44, 0.04);
}
tr:last-child td { border-bottom: none; }
code {
background: rgba(23, 35, 44, 0.06);
border-radius: 6px;
padding: 2px 6px;
font-family: "SFMono-Regular", Menlo, monospace;
}
pre {
overflow-x: auto;
padding: 16px;
border-radius: 18px;
background: #eef6f5;
}
</style>
</head>
<body>
<main>
<section class="hero">
<span class="eyebrow">Copy-paste adoption kits</span>
<nav class="mini-nav" aria-label="Top navigation">
<a href="../">Back to the public landing page</a>
<a href="../compatibility/">Compatibility matrix</a>
<a href="../integrations/">Integration guide</a>
<a href="../skills/">Skills quickstart</a>
<a href="../mcp/">Read-only MCP quickstart</a>
<a href="../builders/">Builder quickstart</a>
</nav>
<h1>Agent starter kits for real coding-agent adoption.</h1>
<p class="lede">
This page exists for the moment after a team says: <strong>“We understand the boundary. Now give us the exact starter files.”</strong>
The kits below keep CortexPilot truthful: <strong>read-only MCP</strong>, <strong>repo-owned skills/bootstrap files</strong>, and
<strong>builder-safe entrypoints</strong> for <strong>Codex</strong>, <strong>Claude Code</strong>, and <strong>OpenClaw</strong>.
</p>
<p class="lede">
These are <strong>starter kits</strong>, not official plugin/store packages. They are the narrowest repo-owned way to make adoption easy without inventing a hosted product, a marketplace listing, or public write-capable MCP.
</p>
<div class="actions">
<a class="button primary" href="#copy-paste-kits">Open copy-paste kits</a>
<a class="button secondary" href="../integrations/">Open integration guide</a>
<a class="button secondary" href="../skills/">Open skills quickstart</a>
<a class="button secondary" href="../mcp/">Open MCP quickstart</a>
</div>
</section>
<section class="section">
<h2>What these kits assume</h2>
<div class="grid">
<article class="card">
<span class="badge primary">Repo-root first</span>
<h3>Start from a real clone</h3>
<p>The fastest truthful setup is still a real CortexPilot clone. These kits assume you are wiring the client from the repo root or from a vendored workspace copy.</p>
</article>
<article class="card">
<span class="badge primary">Read-only only</span>
<h3>MCP stays inspect-only</h3>
<p>The shipped public MCP server is still read-only. Queue preview/cancel and the queue-only pilot server remain guarded repo-operator groundwork, not the public promise.</p>
</article>
<article class="card">
<span class="badge warn">No fake plugin claim</span>
<h3>Stay below store language</h3>
<p>Codex and Claude Code use real MCP configuration paths, and OpenClaw exposes a real MCP registry path, but none of that turns CortexPilot into an official marketplace item today.</p>
</article>
</div>
</section>
<section class="section">
<h2>Default install and verify order</h2>
<p>
The truthful short path is still:
<strong>prove the repo-local path first, then paste one host-tool starter, then verify the proof loop again.</strong>
That keeps adoption honest and stops one copied config file from pretending it already proved a real integration.
</p>
<ol>
<li>Start from a real CortexPilot clone and run the repo-local proof-first path.</li>
<li>Copy exactly one tracked starter file or one local bundle seed.</li>
<li>Keep the first host-tool integration read-only and repo-root scoped.</li>
<li>Confirm success by checking the same proof-first surfaces, not by assuming the pasted file was enough.</li>
</ol>
<pre><code>npm run bootstrap:host
CORTEXPILOT_HOST_COMPAT=1 bash scripts/test_quick.sh --no-related
npm run dev</code></pre>
<p>
This repo-local full-stack path starts the orchestrator API and the dashboard together on localhost, so the browser can use the operator loop without exposing a bearer token on the client.
</p>
<p>
Expected success today:
the quick path finishes cleanly, the orchestrator API plus dashboard start together, and the
<a href="../use-cases/">proof-first use-case loop</a> still routes you
to Workflow Cases, Proof & Replay, and the tracked
<code>news_digest</code> proof assets.
</p>
<p>
If you are iterating on the dashboard shell only, keep <code>npm run dashboard:dev</code>
for the frontend after the API is already running in another terminal.
</p>
</section>
<section class="section">
<h2>Current platform status</h2>
<div class="table-shell">
<table>
<thead>
<tr>
<th>Client</th>
<th>Official host surface</th>
<th>Current CortexPilot status</th>
<th>Safest wording today</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Codex</strong></td>
<td>
Official plugins surface exists.
See <a href="https://developers.openai.com/codex/plugins">OpenAI Codex plugins</a>.
</td>
<td>
Public starter docs, one local marketplace example, and one
portable local bundle exist. No official listing or submission
receipt is tracked here today.
</td>
<td><code>Codex-compatible starter / manual-marketplace-compatible / not officially listed</code></td>
</tr>
<tr>
<td><strong>Claude Code</strong></td>
<td>
Official marketplace, submit, and review flow exist.
See
<a href="https://code.claude.com/docs/en/plugins">plugins</a>
and
<a href="https://code.claude.com/docs/en/discover-plugins">discover plugins</a>.
</td>
<td>
Public starter docs and a local <code>--plugin-dir</code>
bundle seed exist. No official marketplace submission receipt
is tracked here today.
</td>
<td><code>Claude Code-compatible starter / not listed</code></td>
</tr>
<tr>
<td><strong>OpenClaw</strong></td>
<td>
Official ClawHub public registry exists.
See <a href="https://docs.openclaw.ai/tools/clawhub">ClawHub</a>.
</td>
<td>
Public starter docs plus a compatible local bundle path exist.
The matching adoption-router skill is already live on
ClawHub, and the official model remains publish-first rather
than review-queue-first.
</td>
<td><code>OpenClaw-compatible starter / ClawHub skill live</code></td>
</tr>
</tbody>
</table>
</div>
</section>
<section class="section" id="copy-paste-kits">
<h2>Copy-paste starter kits</h2>
<div class="table-shell">
<table>
<thead>
<tr>
<th>Client</th>
<th>Fastest setup</th>
<th>Tracked starter file</th>
<th>Official config reference</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Codex</strong></td>
<td>Use <code>codex mcp add</code> for a repo-root stdio server or drop the TOML snippet into <code>~/.codex/config.toml</code> / <code>.codex/config.toml</code>.</td>
<td><a href="../examples/agent-starters/codex/cortexpilot.config.toml">codex/cortexpilot.config.toml</a></td>
<td><a href="https://developers.openai.com/codex/mcp/">OpenAI Codex MCP docs</a></td>
</tr>
<tr>
<td><strong>Claude Code</strong></td>
<td>Use <code>claude mcp add --transport stdio --scope project</code> for the fastest team-safe setup, or check in a project <code>.mcp.json</code>.</td>
<td><a href="../examples/agent-starters/claude/project.mcp.json">claude/project.mcp.json</a></td>
<td><a href="https://code.claude.com/docs/en/mcp">Claude Code MCP docs</a></td>
</tr>
<tr>
<td><strong>OpenClaw</strong></td>
<td>Use <code>openclaw mcp set</code> with one JSON object when you want OpenClaw-managed outbound MCP server definitions.</td>
<td><a href="../examples/agent-starters/openclaw/cortexpilot-server.json">openclaw/cortexpilot-server.json</a></td>
<td><a href="https://docs.openclaw.ai/cli/mcp">OpenClaw MCP docs</a></td>
</tr>
</tbody>
</table>
</div>
</section>
<section class="section">
<h2>Codex</h2>
<p>Fastest raw direct CLI wiring if you are not copying the tracked config file yet:</p>
<pre><code>codex mcp add cortexpilot-readonly \
-- bash /absolute/path/to/CortexPilot/scripts/run_readonly_mcp.sh</code></pre>
<p>
Need a durable config file instead of a one-line add command? Start from
<a href="../examples/agent-starters/codex/cortexpilot.config.toml">the tracked Codex example</a>.
That tracked file is the canonical wrapper-based template.
</p>
</section>
<section class="section">
<h2>Claude Code</h2>
<p>Fastest raw direct CLI wiring if you are not copying the tracked project file yet:</p>
<pre><code>claude mcp add --transport stdio --scope project \
cortexpilot-readonly \
-- bash /absolute/path/to/CortexPilot/scripts/run_readonly_mcp.sh</code></pre>
<p>
If you want the team-visible file checked into the repo root, start from
<a href="../examples/agent-starters/claude/project.mcp.json">the tracked project <code>.mcp.json</code> example</a>.
That tracked file is the canonical wrapper-based template.
</p>
</section>
<section class="section">
<h2>OpenClaw</h2>
<p>Fastest OpenClaw-managed saved definition:</p>
<pre><code>openclaw mcp set cortexpilot \
'{"command":"bash","args":["/absolute/path/to/CortexPilot/scripts/run_readonly_mcp.sh"],"cwd":"/absolute/path/to/CortexPilot"}'</code></pre>
<p>
Need the JSON object as a tracked file first? Start from
<a href="../examples/agent-starters/openclaw/cortexpilot-server.json">the tracked OpenClaw example</a>.
</p>
</section>
<section class="section">
<h2>What success looks like after install</h2>
<div class="table-shell">
<table>
<thead>
<tr>
<th>Client</th>
<th>Install step you just finished</th>
<th>Next proof check</th>
<th>Success signal today</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Codex</strong></td>
<td>Added the repo-root read-only MCP server or copied the local marketplace seed.</td>
<td>Route back through <a href="../use-cases/">the public use-case guide</a> and confirm the same proof-first loop still makes sense for your repo clone.</td>
<td>The repo-local quick path is still healthy, the starter points at the same repo root, and you are not relabeling a local bundle as an official listing.</td>
</tr>
<tr>
<td><strong>Claude Code</strong></td>
<td>Added the project <code>.mcp.json</code> or copied the local <code>--plugin-dir</code> seed.</td>
<td>Copy the tracked <code>cortexpilot-proof</code> command from the Claude example, then use it to route back to Workflow Cases, Proof & Replay, and the tracked <code>news_digest</code> assets.</td>
<td>You can keep the repo-local proof-first loop, the project config stays read-only, and the Claude starter is still described as local/project adoption rather than a marketplace listing.</td>
</tr>
<tr>
<td><strong>OpenClaw</strong></td>
<td>Saved the JSON server object or merged the tracked TOML bundle path into your OpenClaw config.</td>
<td>Use <a href="../use-cases/">the same public use-case guide</a> as the proof target and keep the OpenClaw story on the read-only proof/replay side.</td>
<td>The bundle path resolves to your local clone, the MCP server stays read-only, and you still describe the result as bundle-compatible rather than live on ClawHub.</td>
</tr>
</tbody>
</table>
</div>
</section>
<section class="section">
<h2>Optional local plugin bundle paths</h2>
<p>
MCP config is the narrowest setup, but the repo also ships one
compatible local bundle for teams that want the same starter pack to
stay portable across Codex, Claude Code plugin-dir development, and
OpenClaw bundle loads.
</p>
<div class="table-shell">
<table>
<thead>
<tr>
<th>Client</th>
<th>Tracked path</th>
<th>How to use it truthfully</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Codex</strong></td>
<td>
<a href="../examples/agent-starters/codex/marketplace.example.json">codex/marketplace.example.json</a>
+ <code>examples/coding-agents/plugin-bundles/cortexpilot-coding-agent-bundle/</code>
</td>
<td>Copy the tracked local marketplace seed, replace its <code>__CORTEXPILOT_REPO_ROOT__</code> placeholder with the absolute path to your repo checkout, then keep the same read-only MCP server definition beside it.</td>
</tr>
<tr>
<td><strong>Claude Code</strong></td>
<td><code>examples/coding-agents/plugin-bundles/cortexpilot-coding-agent-bundle/</code></td>
<td>Use the same bundle for local <code>--plugin-dir</code> development, or keep the lighter project-local <code>.claude</code> + <code>.mcp.json</code> path when plugin packaging is unnecessary.</td>
</tr>
<tr>
<td><strong>OpenClaw</strong></td>
<td>
<a href="../examples/agent-starters/openclaw/config.openclaw.example.toml">openclaw/config.openclaw.example.toml</a>
+ <code>examples/coding-agents/plugin-bundles/cortexpilot-coding-agent-bundle/</code>
</td>
<td>Load the same compatible bundle through <code>plugins.load.paths</code> and keep CortexPilot positioned as the proof / replay / read-only layer rather than a published registry item.</td>
</tr>
</tbody>
</table>
</div>
</section>
<section class="section">
<h2>Pair MCP with repo-owned skills/bootstrap files</h2>
<div class="grid">
<article class="card">
<span class="badge primary">Working contract</span>
<h3>Root AI contract</h3>
<p>Start from <a href="https://github.com/xiaojiou176-open/CortexPilot-public/blob/main/AGENTS.md"><code>AGENTS.md</code></a> when you want the repo's real safety rails, docs-first order, and finish-the-job contract.</p>
</article>
<article class="card">
<span class="badge primary">Docs map</span>
<h3>Minimal read order</h3>
<p>Use <a href="https://github.com/xiaojiou176-open/CortexPilot-public/blob/main/docs/README.md"><code>docs/README.md</code></a> to route the repo's public docs, runbooks, and truth layers without guessing.</p>
</article>
<article class="card">
<span class="badge primary">Codex seed</span>
<h3>Codex-specific working agreement</h3>
<p>Use <a href="https://github.com/xiaojiou176-open/CortexPilot-public/blob/main/policies/agents/codex/AGENTS.cortexpilot.md"><code>policies/agents/codex/AGENTS.cortexpilot.md</code></a> when you want a narrower Codex-governed seed file beside the repo-wide contract.</p>
</article>
</div>
<p>
Need the broader explanation first? Route back through the
<a href="../integrations/">integration guide</a>,
<a href="../skills/">skills quickstart</a>,
<a href="../mcp/">read-only MCP quickstart</a>, and
<a href="../builders/">builder quickstart</a>.
</p>
</section>
<section class="section">
<h2>Repo-local bundle examples</h2>
<p>
Need more than a single MCP config snippet? The repo now also keeps
a tracked <code>examples/coding-agents/</code> tree for local bundle
and project-level starter material.
</p>
<div class="grid">
<article class="card">
<span class="badge primary">Codex</span>
<h3>Local plugin-bundle example</h3>
<p>Use the tracked local bundle example when you want a repo-owned Codex-compatible bundle without claiming a published directory listing.</p>
<p><a href="https://github.com/xiaojiou176-open/CortexPilot-public/tree/main/examples/coding-agents/plugin-bundles/cortexpilot-coding-agent-bundle">Open bundle example</a></p>
</article>
<article class="card">
<span class="badge primary">Claude Code</span>
<h3>Project-local and plugin-dir examples</h3>
<p>Use the tracked slash-command, reviewer, project <code>.mcp.json</code>, and shared bundle examples when you want a truthful Claude Code starter without claiming a published marketplace item.</p>
<p><a href="https://github.com/xiaojiou176-open/CortexPilot-public/tree/main/examples/coding-agents/claude-code">Open Claude Code example</a></p>
</article>
<article class="card">
<span class="badge primary">OpenClaw</span>
<h3>Compatible local bundle example</h3>
<p>Use the tracked OpenClaw README plus the same compatible local bundle when you want a truthful OpenClaw-side adoption story that stays below published registry claims.</p>
<p><a href="https://github.com/xiaojiou176-open/CortexPilot-public/tree/main/examples/coding-agents/openclaw">Open OpenClaw example</a></p>
</article>
</div>
</section>
<section class="section">
<h2>What this page is not claiming</h2>
<ul>
<li>not an official Codex, Claude Code, or OpenClaw plugin/store package</li>
<li>not a hosted operator login surface</li>
<li>not public write-capable MCP</li>
<li>not a replacement for the orchestrator runtime itself</li>
</ul>
</section>
</main>
</body>
</html>