phanthy code

An AI-powered software engineering CLI by phanthy group — edit files, run commands, search codebases, and coordinate agent workflows from your terminal.

🌐 Website: code.phanthy.com — sign up, manage your plan, and get your account before you start.

Quick Start

1. Sign up at code.phanthy.com to create your account and activate a plan.

2. Install the CLI:

   npm install -g @phanthy/phanthy-code

3. Run it — on first launch the CLI opens a browser to sign in through code.phanthy.com:

   phanthy-code

That's it. Once you're signed in, the CLI is ready to use.

What is phanthy code?

phanthy code is a CLI for performing software engineering tasks such as editing files, running commands, searching codebases, and coordinating workflows. It works hand-in-hand with the code.phanthy.com platform, where you register, sign in, and manage your subscription.

• Language: TypeScript
• Runtime: Bun
• Terminal UI: React + Ink
• Scale: ~1,900 files, 512,000+ lines of code

Installation

Install Bun before using the CLI or working on the repository:

curl -fsSL https://bun.sh/install | bash

Install the published CLI with npm:

npm install -g @phanthy/phanthy-code

For local development, install repository dependencies with Bun:

bun install

Authentication

The recommended path is to sign up at code.phanthy.com and let the CLI handle login for you. On first run, the CLI signs in through https://code.phanthy.com and sends model API requests using the stored OAuth access token — no manual configuration required.

Developer token (optional)

If you have a developer API key, you can skip web login:

export PHANTHY_API_KEY="your-api-key"

When PHANTHY_API_KEY is set, the CLI skips web login and calls https://router.phanthy.com by default.

Endpoint overrides (advanced)

export PHANTHY_CODE_BASE_URL="http://localhost:3001"
export PHANTHY_ROUTER_BASE_URL="https://router.phanthy.com"
export PHANTHY_BASE_URL="https://your-phanthy-api.example.com"

PHANTHY_CODE_BASE_URL points OAuth and normal logged-in API traffic at a local or alternate Code deployment. PHANTHY_ROUTER_BASE_URL overrides the API-key router endpoint. PHANTHY_BASE_URL is the strongest override and forces all first-party API traffic to a custom endpoint.

Links

• 🌐 Website / Sign up: code.phanthy.com
• 📦 npm: @phanthy/phanthy-code

Ownership

• Copyright and ownership belong to phanthy group.
• phanthy code is maintained as an independent phanthy group project that uses phanthy API configuration.