Skip to main content

Install

The easiest install path is npm. It downloads a prebuilt GitHub Release binary when the package installs.

npm install -g phonton-cli
phonton doctor
phonton serve   # local RPC for Phonton Desktop (port 47831)

Phonton Desktop can install the CLI automatically during setup, or you can run the command above manually.

Run without installing:

npx phonton-cli doctor

Build from source with Cargo:

cargo install --git https://github.com/phonton-dev/phonton-cli --tag v0.19.0 phonton-cli --locked --force

Check the install:

phonton version
phonton doctor

Download Phonton CLI​

Prebuilt binaries are attached to the latest GitHub release:

npx phonton-cli version

Use npm for the normal path. Use the release assets when npm is unavailable or when a script needs a pinned binary artifact.

Expected first run​

phonton doctor should be the first command after installation. It gives a compact view of the local setup:

config: ok
provider: configured
git: available
cargo: available
store: ready

If provider setup fails, continue with Configure.

Install Phonton Desktop​

Phonton Desktop is a free native control room. Download installers from phonton.dev/desktop or GitHub Releases.

System requirements​

  • Windows 10 or later (x64)
  • macOS 12 or later (Apple Silicon)
  • Linux Ubuntu 22.04+ or equivalent (x64 AppImage or .deb)
  • Free phonton.dev account

First run​

  1. Install and open Phonton Desktop.
  2. Complete the setup wizard: theme → Sign in with browser → install CLI if prompted.
  3. The browser returns to Desktop via phonton://auth/callback after sign-in.
  4. Optional: paste a Pro/Ultra cloud sync token from Account in Desktop settings.

CLI dependency​

Desktop runs goals through phonton serve on port 47831. Install the CLI if the wizard does not:

npm install -g phonton-cli
phonton doctor

Verify checksums from the SHA256SUMS.txt file on each GitHub Release.

Current status​

Phonton CLI is a pre-1.0 public alpha. Use it if you are comfortable running a Rust binary, reading diagnostics, and filing sharp bug reports.