Koolbase CLI

Deploy and manage your Koolbase functions, cron schedules, and more from the terminal.

Installation

Build from source — requires Go 1.21+:

git clone https://github.com/kennedyowusu/koolbase-cli
cd koolbase-cli
go build -o koolbase .
mv koolbase /usr/local/bin/koolbase

Verify the installation:

koolbase --help

Login

Authenticate with your Koolbase account. Uses the same credentials as the dashboard at app.koolbase.com.

koolbase login

Your session token is saved to ~/.koolbase/config.json.

Quick start

# Login
koolbase login

# Deploy a TypeScript function
koolbase deploy send-email --file ./send_email.ts --project <project_id>

# Deploy a Dart function
koolbase deploy process-order --file ./process.dart --project <project_id>

# List functions
koolbase functions list --project <project_id>

# Invoke a function
koolbase invoke send-email --project <project_id> --data '{"to":"user@example.com"}'

# View logs
koolbase logs send-email --project <project_id>

# Add a cron schedule
koolbase crons add send-email --cron "0 9 * * *" --project <project_id>

Config file

The CLI stores your session in ~/.koolbase/config.json. You can set a default project ID to avoid passing --project on every command:

~/.koolbase/config.jsonJSON
{
  "api_key": "your-session-token",
  "base_url": "https://api.koolbase.com",
  "project_id": "your-default-project-id"
}