> ## Documentation Index
> Fetch the complete documentation index at: https://docs.photon.codes/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use Stable documentation by default. Honor an explicit Beta request or a URL under /docs/beta/. If the requested version conflicts with the installed CLI package or API origin, clarify the target before writing integration code.
> Pages under /docs/beta/ document Beta; other product pages document Stable. Keep the CLI package, commands, API origin, and credentials within the selected version. State the documentation version in your answer.
> For MCP search, always pass version: Stable or version: Beta. Unfiltered search mixes both versions. For filesystem reads, keep Beta queries under /beta/ and exclude /beta/ from Stable queries; discover paths before reading them.
> The public docs base is https://photon.codes/docs. Convert MCP page paths to public URLs under that base, preserving /beta/ when present. Read https://photon.codes/docs/skill.md for version selection and https://photon.codes/docs/llms.txt for the version indexes.

# Photon CLI

> Manage Photon accounts, projects, and platform resources from your terminal.

Photon CLI is a typed command-line client for Photon. Use it to sign in, switch
between projects, buy and configure phone numbers and email domains, register
for 10DLC, manage API keys and webhooks, and script all of it from CI.

It installs with npm, pnpm, Yarn, or Bun, runs on Node.js 22 or newer, and also
ships as a standalone binary for macOS, Linux, and Windows.

<Note>
  The current beta talks only to `https://api.staging.photon.codes`.
</Note>

```sh theme={null}
npm install --global photon-cli
photon login
photon project list
```

## Start here

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/docs/beta/cli/installation">
    Install the CLI with a package manager or as a standalone binary.
  </Card>

  <Card title="Authentication" icon="key" href="/docs/beta/cli/authentication">
    Sign in with a device code and manage your stored session.
  </Card>

  <Card title="Service keys" icon="robot" href="/docs/beta/cli/service-keys">
    Give CI and automation a non-interactive credential.
  </Card>

  <Card title="Projects" icon="folder" href="/docs/beta/cli/projects">
    Select an active project and work with its resources.
  </Card>
</CardGroup>

## Work with your resources

<CardGroup cols={2}>
  <Card title="Platform resources" icon="phone" href="/docs/beta/cli/projects/platform">
    Buy phone numbers, verify email domains, and route voice calls.
  </Card>

  <Card title="API keys" icon="lock" href="/docs/beta/cli/projects/api-keys">
    Issue and revoke project API keys.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/docs/beta/cli/projects/webhooks">
    Subscribe endpoints to project events.
  </Card>

  <Card title="Organizations" icon="users" href="/docs/beta/cli/organizations">
    Invite teammates, manage roles, and select an organization.
  </Card>
</CardGroup>

## Compliance and automation

<CardGroup cols={2}>
  <Card title="10DLC registration" icon="building-columns" href="/docs/beta/cli/compliance/10dlc">
    Register brands and campaigns for A2P messaging.
  </Card>

  <Card title="Call Registry" icon="shield-check" href="/docs/beta/cli/compliance/call-registry">
    Register numbers with the Photon Call Registry.
  </Card>

  <Card title="JSON output" icon="brackets-curly" href="/docs/beta/cli/output">
    Machine-readable results, errors, and exit codes.
  </Card>

  <Card title="Recoverable operations" icon="rotate" href="/docs/beta/cli/operations">
    Replay a mutation whose result you never saw.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.