Skip to main content

Install

npm install -g phonton-cli
phonton version    # expect 0.25.1 or newer
phonton doctor --provider

The package downloads the matching binary from the GitHub release. Newer npm versions may warn that phonton-cli has install scripts not covered by allowScripts. Nothing is broken: if npm skipped the script, the first phonton command downloads the binary instead.

Try without installing globally:

npx phonton-cli doctor

What phonton doctor checks​

  • Config file at ~/.phonton/config.toml
  • Provider name and API key
  • Git and the toolchains your project uses (cargo, node)
  • Local store and workspace trust

Fix any warnings before your first real goal. Run phonton doctor --provider to test a live completion call.

Build from source (optional)​

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

Phonton Desktop (optional)​

Desktop is free and needs no account. It talks to the Phonton engine over phonton serve on 127.0.0.1:47831.

  1. Download from phonton.dev/desktop
  2. On macOS and Linux, install the CLI first (npm install -g phonton-cli); the Windows build includes the engine
  3. Open Local models to set up a model, then open a repository and describe a change

Requirements: Windows 10+, macOS 12+ (Apple Silicon), or Ubuntu 22.04+ (x64).

First launch​

phonton          # interactive TUI
# or
phonton goal "add input validation to config loading"

Trust your workspace when asked. Phonton needs read/write access inside the repo you are working on.