Skip to content

The Skyflo Kubernetes agent is deprecated. It is a separate Apache-2.0 open-source project in its own repository, not part of Skyflo Desktop. These pages stay available for existing installations and are no longer updated. Skyflo today is a Mac app where AI agents do real work for you, including Codex, Claude Code and Cursor Agent.

Read the Skyflo documentation

Authentication & Teams

Skyflo uses JWT-based authentication with refresh token rotation. The first registered user becomes the admin.

First Login

After installation, open the Command Center and register the first account. This account automatically becomes the admin with full permissions.

Authentication Flow

  1. Login via POST /auth/jwt/login stores auth_token and refresh_token as HttpOnly cookies.
  2. Access tokens expire after 15 minutes (configurable via jwtAccessTokenExpireMinutes).
  3. Refresh tokens are rotated automatically every 14 minutes. Valid for 7 days by default.
  4. Logout revokes the refresh token and clears cookies.

Token Configuration

Set these in the Helm values under engine.config:

SettingDefaultDescription
jwtAlgorithmHS256JWT signing algorithm
jwtAccessTokenExpireMinutes15Access token lifetime
jwtRefreshTokenExpireDays7Refresh token lifetime

The jwtSecret under engine.secrets is auto-generated on first install and preserved across upgrades.

Team Management

Admins can manage team members from the Command Center settings:

  • Add members with email and role assignment
  • Update roles for existing members
  • Remove members from the team

Roles

RolePermissions
AdminFull access. Manage team, integrations, approve operations.
MemberUse the agent, approve operations, view conversations.

SSO

The open-source project does not include SAML 2.0 or OIDC single sign-on. A paid Team plan for this agent is not offered.

Authentication & Teams: Kubernetes agent (legacy) | Skyflo