Skip to main content

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.

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

​
Install

npm install -g @edgespark/cli
Verify the installation: 
edgespark --version

​
Authenticate

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: 
edgespark whoami
To log out: 
edgespark logout

​
Scaffold a project

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: 
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: 
edgespark init my-app --agent codex --scaffold

​
Get help

Every command has a --help flag that lists its options and usage: 
edgespark --help
edgespark deploy --help
edgespark secret --help
See Commands for an overview of all available commands.

​
See also

CLI commands

Full reference for all edgespark commands and their flags.

Quickstart

Create your first fullstack project and deploy it in minutes.
Last modified on April 9, 2026