@firekid/forge

Official CLI for ForgeDB. Powered by @firekid/hurl.

Install

npm install -g @firekid/forge

Auth

forge login              # GitHub / Google OAuth via browser
forge login --api        # Paste a CLI token from Settings
forge logout
forge whoami

Generate CLI tokens at Settings → CLI Tokens in the dashboard.

Projects

forge projects list
forge projects create my-app
forge projects rename <id> new-name
forge projects delete <id>

Tables

forge tables list --project <id>
forge tables create users --project <id>
forge tables delete users --project <id>

Columns

forge columns list users --project <id>
forge columns add users score number --project <id> --required
forge columns add users slug string --project <id> --unique
forge columns remove users score --project <id>

Types: string · number · boolean · date · json · array

Rows

forge rows list users --project <id>
forge rows list users --project <id> --page 2 --limit 50
forge rows list users --project <id> --search john

forge rows get users 42 --project <id>

forge rows insert users --data '{"name":"John","email":"[email protected]"}' --project <id>

forge rows update users 42 --data '{"name":"Jane"}' --project <id>

forge rows delete users 42 --project <id>

API Keys

forge keys list --project <id>
forge keys create "mobile-app" --project <id> --env prod --permissions read_write
forge keys create "readonly" --project <id> --permissions read
forge keys revoke <key-id> --project <id>

SQL

forge query "SELECT * FROM users WHERE active = 1" --project <id>
forge query --file ./migration.sql --project <id>

Import / Export

# Import CSV into a table
forge import users ./users.csv --project <id>

# Export table to CSV (stdout)
forge export users --project <id> > backup.csv

Logs

forge logs --project <id>           # last 50 requests
forge logs --project <id> --tail    # live stream

Usage & Status

forge usage --project <id>    # requests, storage, row count
forge status                  # check API health

Help

forge help
forge help login
forge help rows insert
forge help tables

Global Options

| Flag | Description | |------|-------------| | --project <id> | Project ID | | --env <prod\|test> | Environment (default: prod) |

License

MIT © Firekid