> ## 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.

> [!WARNING]
>
> **Beta is a preview.** The Beta (2.0) platform does not have all the features
> of [Stable](https://docs.photon.codes/docs/spectrum-ts/introduction.md) yet. For example, iMessage on Beta
> supports only text and images, so tapbacks, polls, message effects, and voice
> notes are [only on Stable](https://docs.photon.codes/docs/spectrum-ts/providers/imessage/messaging-features.md)
> for now. Use Stable for production agents, and confirm that Beta supports the
> features you need before you buy a plan.

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, 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.

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

## Start here

> [card] [Installation](https://docs.photon.codes/docs/beta/cli/installation.md)
>
> Install the CLI with a package manager or as a standalone binary.

> [card] [Authentication](https://docs.photon.codes/docs/beta/cli/authentication.md)
>
> Sign in with a device code and manage your stored session.

> [card] [Service keys](https://docs.photon.codes/docs/beta/cli/service-keys.md)
>
> Give automation that acts as your account a non-interactive credential.

> [card] [Projects](https://docs.photon.codes/docs/beta/cli/projects.md)
>
> Select an active project and work with its resources.

## Work with your resources

> [card] [Platform resources](https://docs.photon.codes/docs/beta/cli/projects/platform.md)
>
> Buy phone numbers, verify email domains, and route voice calls.

> [card] [API keys](https://docs.photon.codes/docs/beta/cli/projects/api-keys.md)
>
> Issue and revoke project API keys.

> [card] [Webhooks](https://docs.photon.codes/docs/beta/cli/projects/webhooks.md)
>
> Subscribe endpoints to project events.

> [card] [Organizations](https://docs.photon.codes/docs/beta/cli/organizations.md)
>
> Invite teammates, manage roles, and select an organization.

## Automation

> [card] [JSON output](https://docs.photon.codes/docs/beta/cli/output.md)
>
> Machine-readable results, errors, and exit codes.

> [card] [Recoverable operations](https://docs.photon.codes/docs/beta/cli/operations.md)
>
> Replay a mutation whose result you never saw.


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