> ## Documentation Index
> Fetch the complete documentation index at: https://docs.edgespark.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Install EdgeSpark CLI and scaffold a project

> Install the EdgeSpark CLI, sign in with edgespark login, and scaffold the current full-stack project layout for Cloudflare deployments.

The EdgeSpark CLI (`edgespark`) is the primary tool for creating projects, deploying code, and managing platform resources.

## Install

```bash theme={null}
npm install -g @edgespark/cli
```

Verify the installation:

```bash theme={null}
edgespark --version
```

## Authenticate

```bash theme={null}
edgespark login
```

This opens your browser for authentication. Once approved, your credentials are stored locally in `~/.edgespark/credentials.json` and used for subsequent CLI commands.

If you run `edgespark login` from a non-interactive agent session, the CLI prints a verification URL and stores pending login state. After you approve the browser flow, the next CLI command completes the login automatically.

To check who you're logged in as:

```bash theme={null}
edgespark whoami
```

To log out:

```bash theme={null}
edgespark logout
```

## Scaffold a project

```bash theme={null}
edgespark init my-app --agent codex
```

The scaffold now creates a fullstack project with `server/`, `web/`, `configs/`, and `edgespark.toml`.

`--agent` is required. Use `--agent claude` for Claude Code, `--agent gemini` for Gemini CLI, `--agent codex` for OpenAI Codex, and the real agent name for every other AGENTS.md-based tool, such as `copilot`, `cursor`, `opencode`, `amp`, `devin`, `aider`, `windsurf`, `cline`, `continue`, `antigravity`, `kiro`, or your own custom agent name.

Install dependencies in each directory separately:

```bash theme={null}
cd my-app/server && npm install
cd ../web && npm install
```

If you want local files only and do not want to create a remote project yet:

```bash theme={null}
edgespark init my-app --agent codex --scaffold
```

## Get help

Every command has a `--help` flag that lists its options and usage:

```bash theme={null}
edgespark --help
edgespark deploy --help
edgespark secret --help
```

See [Commands](/cli/commands) for an overview of all available commands.

## See also

<Columns cols={2}>
  <Card title="CLI commands" icon="terminal" href="/cli/commands">
    Full reference for all `edgespark` commands and their flags.
  </Card>

  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Create your first fullstack project and deploy it in minutes.
  </Card>
</Columns>