jack-cloud

# Jack Cloud — Deploy Anything from the Terminal

Jack deploys Cloudflare Workers projects in one command. Create an API, add a database, ship it live — all from the terminal.

## Install

```bash
npm i -g @getjack/jack
jack login
```

## External Endpoints

| Endpoint | Data Sent | Purpose |
|----------|-----------|---------|
| `auth.getjack.org` | OAuth tokens (GitHub/Google via WorkOS) | Authentication |
| `control.getjack.org` | Project metadata, source code during deploy | Project management and deployments |

## Security & Privacy

- `jack login` authenticates via browser OAuth (GitHub/Google via WorkOS). Auth token stored at `~/.config/jack/auth.json`
- No environment variables required — authentication is interactive
- Source code is uploaded during `jack ship` and deployed to Cloudflare Workers via Jack Cloud
- Project metadata (name, slug, deploy history) is stored on Jack Cloud
- No telemetry is sent without user consent (`jack telemetry` to configure)
- **npm package:** [@getjack/jack](https://www.npmjs.com/package/@getjack/jack) — open source CLI

## MCP Tools

If your agent has `mcp__jack__*` tools available, prefer those over CLI commands. They return structured JSON and are tracked automatically. The CLI equivalents are noted below for agents without MCP.

---

## Create & Deploy a Project

```bash
jack new my-api
```

This creates a project from a template, deploys it, and prints the live URL.

**Pick a template** when prompted (or pass `--template`):

| Template | What you get |
|----------|-------------|
| `api` | Hono API with example routes |
| `hello` | Minimal hello-world starter |
| `miniapp` | Full-stack app with frontend |
| `ai-chat` | AI chat app with streaming |
| `nextjs` | Next.js full-stack app |

Run `jack new` to see all available templates.

**MCP:** `mcp__jack__create_project` with `name` and `template` params.

After creation, your project is live at `https://<slug>.runjack.xyz`.

---

## Deploy Changes

After editing code, push...