SurgeDev CLI

Manage your SurgeDev backend from the command line — database, storage, auth, all in one tool.

Install

npm install -g surgedev-cli

Quick Start

# 1. Set your API credentials
export SURGEDEV_API_URL=http://localhost:7130
export SURGEDEV_API_KEY=ik_xxx

# 2. Test the connection
surgedev ping

# Or use a .env file in your project root
echo "SURGEDEV_API_URL=http://localhost:7130" >> .env
echo "SURGEDEV_API_KEY=ik_xxx" >> .env

Commands

Database

surgedev db list                              # List all tables
surgedev db schema <table>                    # Show table structure
surgedev db create <table> --columns '[...]'  # Create a table
surgedev db drop <table>                      # Drop a table
surgedev db query <table>                     # Query records
surgedev db insert <table> --data '[...]'     # Insert records
surgedev db update <table> --filter '{}' --data '{}'  # Update records
surgedev db delete <table> --filter '{}'      # Delete records
surgedev db sql "SELECT * FROM users"         # Run raw SQL

Query with filters (PostgREST style):

surgedev db query users --filter '{"age":"gt.18","status":"eq.active"}' --select id,name --limit 10

Create a table:

surgedev db create posts --columns '[
  {"name": "title", "type": "string", "nullable": false},
  {"name": "content", "type": "text"},
  {"name": "published", "type": "boolean", "default": "false"}
]'

Storage

surgedev storage ls                           # List all buckets
surgedev storage create <bucket>              # Create a bucket
surgedev storage create <bucket> --private    # Create a private bucket
surgedev storage drop <bucket>                # Delete a bucket
surgedev storage objects <bucket>             # List files in a bucket

Auth

surgedev auth users                           # List registered users
surgedev auth users --search "alice"          # Search users
surgedev auth config                          # View auth configuration

Utility

surgedev ping                                 # Test backend connection

Configuration

| Environment Variable | Description | Default | |---|---|---| | SURGEDEV_API_URL | Backend API URL | http://localhost:7130 | | SURGEDEV_API_KEY | API Key (required) | — |

You can also place a .env file in your project root or the CLI's install directory.

Use with AI Agents

SurgeDev CLI is designed to be used by AI coding agents (Cursor, Claude Code, etc.) via terminal. The AI runs CLI commands directly — no MCP protocol needed.

AI Agent → terminal → surgedev CLI → SurgeDev Backend API

License

Apache-2.0