Developers

Mint Code Runner tokens, use the gf CLI, and deploy with the Coderunner MCP — without creating Apps for workloads.

Developers (sidebar → Administer) is the portal home for short-lived Code Runner JWTs, sample curl headers, and links into the deploy tooling. Use it together with the gf CLI and Coderunner MCP for local and agent-driven deploys.

Coderunner is the deploy path (D-061). Do not create an App just to run a function, job, schedule, or service. POST …/apps with app_kind=coderunner is rejected.

Portal: Code Runner token

Open Developers

Select a workspace, then open Administer → Developers.

Generate a token

Mint (or regenerate) a short-lived JWT. Copy the Bearer token, Control Plane base URL, x-client-key (workspace id), and x-userid. Tokens expire in about five minutes.

Call an API

Use the sample curl from the page. Workspace gf_* API keys are not valid for Code Runner — use the minted JWT or gf token.

gf CLI

Install from the Groundfloor monorepo (@groundfloor/cli), then:

gf login                  # browser sign-in (IdPlane PKCE)
gf whoami
gf workspaces
gf workspaces use <uuid>
gf coderunner ls
gf deploy                 # zip cwd → create/upload/build/deploy/poll

Useful patterns:

eval "$(gf env)"          # GROUNDFLOOR_TOKEN, CONTROLPLANE_URL, …
gf deploy --git https://github.com/me/my-fn.git --ref main
gf deploy --name my-fn --runtime python --workload-type function

Optional project defaults live in groundfloor.json (name, runtime, workloadType, resources, env). CLI flags override the file.

Command area	Purpose
`login` / `token` / `env`	Session and Bearer for scripts
`workspaces`	List and set default workspace
`coderunner ls\|status\|run`	Inspect and invoke
`deploy`	Full create → upload → build → deploy lifecycle

Bind a helper to an existing product App with --app-id only when you already have an App — never create an App solely for deploy.

Coderunner MCP

The @groundfloor/coderunner-mcp server exposes tools for agents: list/create, upload, poll build, deploy, poll deploy, status, run, logs, and coderunner_deploy_folder. Authenticate with GROUNDFLOOR_TOKEN or output from gf token.

Git push-to-deploy

On a coderunner detail page, connect a Git source (or PUT …/coderunners/{id}/git-source). Point GitHub/Gitea at POST /v1/webhooks/git/{source_id} with the webhook secret. Private repos reference a workspace Secret by key.

Coderunner — portal workload management
Coderunner overview — architecture and auth headers
Apps — optional product packaging (Shell / standalone), not the deploy path
API authentication

Developers

On this page