feat: add agent-driven Caplets setup

[ian-pascoe]

Summary

Agents can now bootstrap Caplets from the landing page without rushing into package installs or config edits. The setup section now lets visitors flip between Manual commands and an Agent path whose button copies the full guarded prompt while only showing a compact preview on the page.

The new installer skill makes first-run setup a consented flow: probe read-only state, ask for target/runtime/package-manager choices, present exact commands and affected config, then verify both the CLI and selected agent wiring. Its troubleshooting runbooks give agents focused recovery paths for CLI/PATH problems, daemon health, agent/MCP/native config, and self-hosted remote login without pulling every failure mode into the bootstrap prompt.

Validation

• python - <<'PY' ... structure check for installer skill frontmatter, raw GitHub URLs, and referenced files
• pnpm --filter @caplets/landing test -- test/activation-links.test.ts test/observability.test.ts
• pnpm format:check
• pnpm --filter @caplets/landing typecheck
• pnpm --filter @caplets/landing build
• git push pre-push hook ran pnpm verify successfully: format, lint, code-mode API check, schema check, docs check, typecheck, tests (144 files / 2032 tests), benchmark check, and build

---

[coderabbitai]

Warning

Review limit reached

@ian-pascoe, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 24 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: bf4d111e-1461-44f3-979d-70d9377ffc0a

📥 Commits

Reviewing files that changed from the base of the PR and between 2e87443 and 57488ff.

📒 Files selected for processing (3)

• packages/core/src/cli.ts
• packages/core/src/cli/doctor.ts
• packages/core/test/doctor-cli.test.ts

📝 Walkthrough

[!WARNING]

Walkthrough skipped

File diffs could not be summarized.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch worktree/quiet-meadow-3c2d

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[greptile-apps]

Greptile Summary

This PR adds an agent-guided Caplets setup path from the landing page. The main changes are:

• Manual and Agent setup tabs in the hero.
• Raw prompt copying without command attribution.
• A new installing-caplets skill and troubleshooting references.
• caplets doctor --format support for plain, markdown, and JSON output.

Confidence Score: 5/5

This looks safe to merge.

• No blocking issues found in the changed code.

Important Files Changed

Filename	Overview
packages/core/src/cli.ts	Adds doctor --format parsing and routes doctor output to JSON, plain text, or markdown.
packages/core/src/cli/doctor.ts	Adds markdown doctor formatting while preserving existing plain and JSON report paths.
skills/installing-caplets/SKILL.md	Adds the agent-facing Caplets installer flow with read-only probing, planning, execution, and verification steps.
apps/landing/src/components/landing/Hero.astro	Replaces the quickstart card with Manual and Agent setup tabs and copy actions.
apps/landing/src/scripts/copy.ts	Lets copy buttons opt out of command attribution so prompt text is copied verbatim.

_{Reviews (5): Last reviewed commit: "feat(core): support doctor output format..." | Re-trigger Greptile}

[github-actions]

Preview Deployed

Landing: https://pr-188.preview.caplets.dev
Docs: https://docs.pr-188.preview.caplets.dev
Catalog: https://catalog.pr-188.preview.caplets.dev

Built from commit 3296a86