Command reference

Synopsis

railgrid connects Kubernetes clusters and Linux servers behind NAT to one hub, and gives every team an isolated workspace with its own APIs, RBAC and providers on top.

Typical session:

railgrid login --hub-url https://hub.example.com   # OIDC in the browser
railgrid use                                        # pick an org and workspace
railgrid edge list                                  # what is connected
railgrid connect my-cluster                         # point kubectl at an edge
railgrid ssh my-server                              # shell on a Linux edge
railgrid whoami                                     # where am I, what can I do

Every command talks to the hub as you, with your workspace RBAC. Run ‘railgrid <command> –help’ for details and ‘railgrid completion –help’ for shell completion.

Options

  -h, --help                       help for railgrid
      --insecure-skip-tls-verify   Skip TLS certificate verification when talking to the hub
      --kubeconfig string          Path to the kubeconfig file (default: $KUBECONFIG, then ~/.kube/config)

See also

• railgrid agent — Run, install or upgrade the edge agent on a cluster or server
• railgrid app — Manage App Studio projects: list, create, status, sync, promote, publish
• railgrid commit — Record local git commits through railgrid (code__commit_files)
• railgrid completion — Generate the autocompletion script for the specified shell
• railgrid connect — Point kubectl at a Kubernetes edge
• railgrid dev — Manage development environment for railgrid
• railgrid disconnect — Point kubectl back at the hub workspace
• railgrid edge — Create, list, inspect and remove edges (clusters and servers)
• railgrid env — Print shell exports for calling the hub as you
• railgrid init — Run a railgrid hub in-process (server side, not a client command)
• railgrid install — Install the railgrid agent
• railgrid login — Log in to a railgrid hub (browser OIDC flow, or a static token)
• railgrid logout — Forget the hub credentials on this machine
• railgrid mcp — MCP endpoints for AI clients (Claude Code, Cursor, Codex)
• railgrid org — Organizations you belong to, and who is in them
• railgrid sandbox — Drive a development-mode instance: sync, exec, logs, restart, status
• railgrid skills — Install agent skills from the railgrid repository into Claude Code and Codex
• railgrid ssh — Open an SSH session to a Linux server edge via the hub
• railgrid token — Print a bearer token for the hub (refreshing it when needed)
• railgrid use — Switch the active organization and workspace
• railgrid version — Print version information
• railgrid whoami — Show who you are logged in as, and where kubectl points
• railgrid workspace — Workspaces of an organization, and who is in them