# ccweb — Claude Code Web Setup

> Bootstrap Claude Code web environments with one command.

ccweb generates setup scripts for Claude Code cloud VMs (Ubuntu 24.04).
It creates setup.sh (system provisioning), session-start.sh (SessionStart hook),
diagnose.sh (runtime diagnostics), and wires .claude/settings.json.

## Install

No install needed. Run directly with uv:

```
uvx ccweb init
```

Or install globally:

```
pip install ccweb
```

## Usage

```
# Install all toolchains and extras
uvx ccweb init

# Just Node.js and Python
uvx ccweb init --toolchains node,python

# Go project with gh CLI
uvx ccweb init --toolchains go --extras gh

# Overwrite existing files
uvx ccweb init --force

# Check environment status
uvx ccweb doctor
```

## Toolchains

node, python, go, rust, ruby, java, deno, elixir, zig, dotnet, php

## Extras

gh (GitHub CLI), uv (Python package manager), pnpm, yarn, bun, browser (Playwright Chromium), sqlite, postgres (client), redis (CLI), docker (CLI)

## Generated Files

- `scripts/setup.sh` — System-level provisioning. Paste into claude.ai/code "Setup script" field, or let session-start.sh auto-run it.
- `scripts/session-start.sh` — SessionStart hook. Detects lockfiles and installs project dependencies automatically.
- `scripts/diagnose.sh` — Runtime diagnostics. Run anytime to check what's installed and configured.
- `.claude/settings.json` — Hooks and permissions. Merges with existing settings, never clobbers.

## Links

- Source: https://github.com/nclandrei/ccw
- PyPI: https://pypi.org/project/ccweb/
- Web: https://ccweb.nicolaeandrei.com
