@photon-ai/cli 0.4.0 → 1.1.0

package/README.md

@@ -107,14 +107,30 @@ photon billing show
 `pho` is a shortcut for `photon`, useful for high-frequency commands. Every global install (npm / pnpm / yarn / bun) wires up both `photon` and `pho` automatically — they're declared as sibling `bin` entries that point at the same binary, so no setup is needed:
 
 ```sh
-pho ls          # photon projects ls
-pho whoami
+pho projects ls   # same as: photon projects ls
+pho whoami        # same as: photon whoami
 ```
 
+`pho` is a drop-in alias — it accepts the exact same commands and flags as `photon`, just fewer keystrokes to type. There's no top-level `ls` shortcut; list projects with the full `projects ls` path (`pho projects ls`).
+
 For `npx` / `bunx`, the package name itself is what you type, so `npx @photon-ai/cli` runs `photon` (the first declared bin). To run `pho` explicitly through `npx`, use `npx --package=@photon-ai/cli pho`.
 
 ---
 
+## Use with AI agents
+
+There's a `photon-cli` [Agent Skill](https://skills.sh/) that teaches AI agents (Claude Code, Cursor, Copilot, OpenCode, and [25+ others](https://skills.sh/)) how to drive this CLI — the login flow, project bootstrapping, billing/upgrades, Spectrum resources, and config/environment resolution. Install it from [`photon-hq/skills`](https://github.com/photon-hq/skills):
+
+```sh
+npx skills add photon-hq/skills --skill photon-cli
+```
+
+Once installed, supported agents pick it up automatically — try *"log in to Photon, create a project, and tell me its id and secret"* or *"how many Spectrum lines does my project have, and how do I upgrade it to a business line?"*
+
+The same collection ships skills for Photon's other SDKs — [`imessage`](https://github.com/photon-hq/skills/tree/main/skills/imessage), [`spectrum`](https://github.com/photon-hq/skills/tree/main/skills/spectrum), [`chat-adapter-imessage`](https://github.com/photon-hq/skills/tree/main/skills/chat-adapter-imessage), and [`buildspace-ci-cd`](https://github.com/photon-hq/skills/tree/main/skills/buildspace-ci-cd). Browse them all at [photon-hq/skills](https://github.com/photon-hq/skills).
+
+---
+
 ## Concepts
 
 ### Backend host
@@ -256,7 +272,7 @@ The CLI's config root is resolved in this order:
 
 If a legacy `~/.config/photon-dashboard/` directory exists from a prior pre-rename install, it migrates automatically to the new path on first run.
 
-Other env vars: `PHOTON_TYPES_SRC` (maintainer-only, for `bun run sync:api`), `PHOTON_NO_UPDATE_NOTIFIER=1` (mute update prompt).
+Other env vars: `PHOTON_NO_UPDATE_NOTIFIER=1` (mute update prompt).
 
 ---
 
@@ -278,12 +294,9 @@ bun run typecheck
 
 # Build (produces dist/photon.js)
 bun run build
-
-# Sync API types from a sibling `dashboard` checkout (maintainer)
-bun run sync:api
 ```
 
-The CLI's API contract comes from the `@photon-ai/api-public` type bundle, vendored at `types/api.d.ts`. To refresh after the dashboard's API surface changes, run `bun run sync:api` (looks for the sibling checkout by default; set `PHOTON_TYPES_SRC` to override).
+The CLI's API contract comes from the [`@photon-ai/dashboard-api`](https://www.npmjs.com/package/@photon-ai/dashboard-api) package, a types-only bundle of the dashboard's public API (the `PublicApp` Elysia type, used with `@elysiajs/eden` treaty). To pick up dashboard API changes, bump that dependency — its version tracks the dashboard release tag.
 
 See [`docs/cli-design.md`](docs/cli-design.md) and [`docs/cli-build-plan.md`](docs/cli-build-plan.md) for the full architecture notes.