Skip to content
Console
Menu

Alerts and status pages

App store purchases

Credits

Knowledge

KV

Notifications

Organizations

Storage

Workflows

API reference

Getting Started

Authentication

KV Store

CLI

One binary for the whole platform, generated from the same contracts as the API.

sylphx is the platform from a terminal: one binary that calls the same API as the SDKs, generated from the same contracts. 29 services, 158 collections and 735 commands are on the pages below, and the porcelain — login, whoami, link — is hand-written on the same SDK. The API reference is the same surface over HTTP, and Agents and coding assistants is the MCP server.

#Install

Shell
curl -fsSL https://sylphx.com/install/cli | bash
npm install -g @sylphx/cli
cargo install sylphx-cli --locked

The three channels install the same sylphx binary; pick one and keep to it, so one sylphx is on your PATH. Servers and coding agents use the script.

The reference below follows the current API contracts. Release channels may contain fewer commands: check sylphx --version and sylphx --help for your installed command tree. Published CLI compatibility lists known version differences.

#Update

There is no sylphx update: the binary does not update itself. Update the way you installed it — the same command as Install, run again.

#Sign in

sylphx login prints a short code and waits while you approve the request in the browser; the key is stored in your operating system's keychain. Sign in has the flow in full. On a machine with no browser, sylphx login --api-key - reads a key from standard input instead, and SYLPHX_API_KEY is the key a command uses when none is stored.

#Grammar

Text
sylphx <service> <collection> <verb> [NAME|PARENT] [--flags]
  • The service and collection are the tree's own names in kebab-case, so sylphx data databases list is the databases collection of the data service. A collection segment is unique across the platform, so it identifies its service on its own.
  • The verb is the method's verb: list, get, create, update, delete, or the verb a service adds of its own (revoke, rotate).
  • The positional is the resource's NAME, the parent a List runs in (PARENT), or the ID a Create asks for, which the server assigns when it is left out. A bare id is enough for a name below the linked project (sylphx link).
  • The flags are the request's fields in dotted kebab-case: --spec.engine is spec.engine in the body, and an enum flag takes the contract's values. --dry-run is validate_only, and --parent is how a Create names the parent it creates in — every other method takes its parent, or its name, as the positional.

#Global flags

Every generated command takes the two flags the tree declares:

FlagTypeWhat it does
--outputtable|json|yaml|nameOutput format; tables show name, Ready, and age. Default table.
--from-filepathRead the whole request body from a YAML or JSON file.

The binary carries four more of its own, on every command:

FlagTypeWhat it does
--api-keyKEYThe key to sign the call with; when it is left out, SYLPHX_API_KEY, then the key sylphx login stored.
--yesboolDo not ask before a destructive call.
--no-waitboolReturn a long-running call at once instead of waiting for it.
--allboolA list follows every page, not only the first.

#Services

Every collection in the generated command contract, and its service. A collection's reference is at its own page; check the installed CLI help before using a service command.

ServiceCommandCollections
Sylphx Accesssylphx accessOrgs, Projects, Envs, Service enablements, API keys
Sylphx Agentssylphx agentsTransfers, Agents, Agent versions, Agent sessions, Goals, Waits, Queued executions, Session events, Memory stores, Memories, Owner pools
Sylphx AIsylphx aiAI models
Sylphx Analytics (not available yet)sylphx analyticsAnalytics events
Sylphx Artifactssylphx artifactsArtifacts
Sylphx Generated Assetssylphx assetsAssets
Sylphx Authsylphx authAuth configs, End users, Sessions, Identities, Customer organizations, Memberships, Organization roles, Trusted issuers, Invitations, Email domains, OAUTH clients
Sylphx Billing (not available yet)sylphx billingMeters, Plans, Billing accounts, Invoices, Usage reports, Budget leases
Sylphx Brokersylphx brokerTrust policies, Token exchanges
Sylphx Buildsylphx buildBuilds, Build caches
Sylphx Configsylphx configConfig flags, Config segments, Config changes
Sylphx Connectionssylphx connectionsConnection providers, Connections
Sylphx Datasylphx dataDatabases, KV namespaces, Buckets, Search indexes
Sylphx Entitlement (not available yet)sylphx entitlementEntitlements
Sylphx Eventssylphx eventsTopics, Events, Connectors, Subscriptions, Queues, Webhook endpoints, Webhook deliveries, Inbound endpoints, Realtime channels, Realtime messages, Realtime members
Sylphx Hostingsylphx hostingUptime manifests, Serving routes, Service observations, Services, Service rollouts, Previews, Source links
Sylphx Keyssylphx keysKeys, Key versions
Sylphx Knowledgesylphx knowledgeSpaces, Knowledge schemas, Episodes, Entities, Relations
Sylphx Localizationsylphx localizationCatalogs, Entries, Glossaries
Sylphx Moneysylphx moneyProcessor events, Merchant accounts, Price catalogs, Checkout policies, Store connections, Store purchases, Customer subscriptions, Entitlement grants, Checkout sessions, Tax threshold statuses, Portal sessions, Licence keys, Licence tokens, Usage settings, Usage tiers, Usage reservations, Usage events, Credit grants, Usage invoices, Usage meters, Usage meter prices, Revenue sources, Revenue, Revenue facts, Exchange rates
Sylphx Network (not available yet)sylphx networkDomains, Certificates, Routes, Egress identities, Private links
Sylphx Notifysylphx notifyPhone numbers, Mail domains, Mail routes, Senders, Recipients, Preferences, Message topics, Suppressions, Templates, Messages, Mailboxes, Mailbox OAUTH apps, Mailbox connect links, Inbound emails, Inbox items, Broadcasts, Sms numbers, Inbound sms
Sylphx Observabilitysylphx observabilityUptime sources, Uptime checks, Log entries, Traces, Generations, Error groups, Error events, Source maps, Scrubbing policies
Sylphx Realtime (not available yet)sylphx realtime—
Sylphx Releasesylphx releaseReleases, Rollouts
Sylphx Runners (not available yet)sylphx runnersScale sets, Runners
Sylphx Sandboxessylphx sandboxesSandbox shapes, Pools, Leases, Lease events, Volumes, Snapshots
Sylphx Secretssylphx secretsSecrets, Secret versions, Secret bindings, Profiles, Profile versions
Sylphx Workflowssylphx workflowsWorkflows, Schedules, Runs, Jobs, Job runs, Distributed jobs, Distributed runs

#Service commands

A few calls belong to a service rather than to a collection, and are typed with the service alone:

CommandMethodWhat it does
sylphx access whoamiaccess.whoamiReturns the caller: the principal and the scope of the key or token that authenticated this request. Clients fill their org, project, and env defaults from it; every valid key may call it, whatever its scopes.

#Porcelain

These verbs are hand-written on the same SDK rather than generated from the tree:

CommandWhat it does
sylphx loginSign in: a browser approval (device flow), or an Access key with --api-key KEY|-
sylphx logoutRevoke the stored key and forget it
sylphx whoamiShow the caller: principal, org, project, env, scopes
sylphx linkLink this directory to an org, project and env (.sylphx/project.json); init is the same command
sylphx apiCall any path of the API directly (raw escape hatch): sylphx api GET /v1/whoami
sylphx mcpRun the Sylphx MCP server over stdio
sylphx completionPrint a shell completion script: sylphx completion bash