Skip to content

docs: installation, quickstart, agents and MCP client setup on cloudhal.dev - #36

Merged
Madraka merged 1 commit into
mainfrom
docs/start-and-agents
Oct 21, 2026
Merged

Madraka merged 1 commit into
mainfrom
docs/start-and-agents

Conversation

@Madraka

@Madraka Madraka commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

Strengthens cloudhal.dev's getting-started and agent docs, after a look at Astro, Supabase, Vercel, Stripe, Convex, Prisma, Sanity and Payload.

New pages

  • /docs/start/installation: requirements, create with npm/pnpm/Yarn/Bun, running the CLI with each, pnpm settings, upgrading.
  • /docs/start/quickstart: create → preview → Studio → connect an agent → ask → deploy → remote agents.
  • /docs/agents: local (cloudhal mcp, stdio) vs remote (/mcp, x-api-key), modes, approvals, the tool groups, skills, keys, security.
  • /docs/agents/clients: Claude Code, Codex, Cursor, VS Code, Claude Desktop/claude.ai, Windsurf, Zed, Gemini CLI, any client; per package manager; troubleshooting.
  • /docs/agents/docs-for-agents: .md pages, llms.txt per section, an AGENTS.md snippet, the schemas.
  • /docs/reference/cli: generated from cloudhal --help (RFC-0037 phase 2, first piece).

Fixes

  • cloudhal init writes minimumReleaseAgeExclude for @cloudhal/* and create-cloudhal into new projects' pnpm-workspace.yaml, so pnpm installs a release on the day it ships (changeset, @cloudhal/cli patch).
  • README: the five-minute steps were missing npm install.

Tests: 17 in @cloudhal/docs (incl. the CLI reference and the internal link contract), the CLI's project-setup test.

🤖 Generated with Claude Code

…al.dev

New pages:
- Start: installation (Node 24; npm, pnpm, Yarn, Bun; running the
  CLI with each) and a quickstart from create to deploy;
- Agents: local vs remote MCP, modes, approvals, tools, skills, remote
  keys; per-client setup for Claude Code, Codex, Cursor, VS Code,
  Claude Desktop, Windsurf, Zed and Gemini CLI; docs for agents;
- Reference: the CLI, generated from cloudhal --help.

New pnpm projects now exempt @cloudhal/* from minimumReleaseAge, so a
release installs on the day it ships. The README's five-minute steps
gain the missing npm install.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Madraka <8898640+Madraka@users.noreply.github.com>
@Madraka
Madraka merged commit 857d75b into main Oct 21, 2026
4 checks passed
@Madraka
Madraka deleted the docs/start-and-agents branch October 21, 2026 11:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant