# MarshHub

> Static site hosting for Mars IT School. Deploy to name.marshub.uz with one command.

MarshHub is a hosting platform where students deploy static sites (HTML, CSS, JS) via CLI. Each site gets a subdomain with automatic HTTPS.

## Documentation

- [Docs](https://marshub.uz/docs/): Complete reference (CLI, API, limits, errors)
- [CLI Page](https://marshub.uz/cli/): Quick start guide with examples
- [Full Reference](https://marshub.uz/llms-full.txt): Complete text reference for AI agents

## Quick Start

```bash
npm i -g marshub
marshub login
marshub deploy --name my-site
# → https://my-site.marshub.uz
```

## Key Facts

- **Package**: `npm i -g marshub` (or `npx marshub`)
- **Auth**: Mars ID cookie for web panel, Telegram bot @marshubbot for CLI login → API key saved to ~/.marshubrc
- **Deploy**: `marshub deploy --name <name>` uploads current directory
- **Agent mode**: output switches to JSON automatically when `CLAUDECODE`, `CURSOR_AGENT` or `MARSHUB_AGENT` env is set (or pass `--json`)
- **MCP server**: `npx marshub mcp` (stdio) — tools: marshub_deploy, marshub_list_sites, marshub_delete_site, marshub_set_status, marshub_whoami
- **Limits**: 50 MB/upload, 1 GB/user, 20 sites/user, 5000 files/site
- **Output**: All CLI messages are in Russian (JSON mode is English)
- **Static only**: HTML, CSS, JS, images. No server-side code (.php, .py blocked)
- **HTTPS**: Automatic via Caddy on-demand TLS
- **Versioned**: Last 5 releases kept, rollback via API

## Commands

| Command | Description |
|---------|-------------|
| `marshub login` | Auth via Telegram |
| `marshub deploy [--name <n>]` | Deploy current dir |
| `marshub ls` | List your sites |
| `marshub status <name> <status>` | Set status (draft/preview/alpha/beta/live) |
| `marshub rm <name>` | Delete site |
| `marshub whoami` | Account info |
| `marshub init` | Add deploy instructions to AGENTS.md/CLAUDE.md/.cursorrules |
| `marshub mcp` | Run MCP server over stdio (for Claude Code / Cursor / Codex) |

## MCP Setup

```bash
# Claude Code
claude mcp add marshub -- npx -y marshub mcp
```