ashlrai/phantom

Phantom runs all engineering and manages resources.
The open-source engineering agent workbench, by AshlrAI.
Connect eligible Claude Code, Codex, Grok or Devin accounts, API credits or
tool-capable local models — then work with agents interactively, or hand the
fleet an outcome, and review the recorded runs, changes and verification it
leaves behind.
Get Phantom ·
Onboarding ·
User guide ·
Desktop app ·
CLI
## Quickstart
sh
node --version # must print v22.15.0 or newer; npm only warns on older Node
npm install -g @ashlr/phantom # phm and the compatible ashlr alias; macOS, Linux and Windows
phm --version # report the installed version
phm verse # serve the console at http://127.0.0.1:7777/verse/
phm verse prints a read token and a mutation token; the server
listens on 127.0.0.1 only, and neither token is written to disk. On an
Apple silicon Mac, the desktop app wraps the same
console in a native window.
New to Phantom? phm.dev/connect is the guided
onboarding path — install, your first seat and your first task. The
first-run guide covers the same ground
inside this repository.
Canonical Phantom releases use @ashlr/phantom from ashlrai/phantom.
This source tree targets version 3.30.0; check canonical release availability and exact matching assets before installation.
Install the promoted npm latest release, or pin a published version from
GitHub releases as
@ashlr/phantom@ ; the source candidate is not proof of publication.
Then, in Phantom:
1. Sign in a seat. A seat is one account and the CLI that drives it,
pinned to its own profile — see Sign in your seats.
Phantom never asks for or stores a credential; each vendor CLI signs
itself in, and a running Ollama adds tool-capable local seats with no
sign-in.
2. Open a project and chat. New chat picks a seat and a folder;
saving a folder as a project never enrolls it for unattended work. The
composer takes attachments, @ files and / commands; ⌘K reaches every
chat, action and seat, and ⌘J opens Needs you.
3. Optionally hand work to the cloud or to Devin.
phm cloud launch " " --repo owner/name, or phm devin connect
once and then phm devin launch " " — see
the cloud and Devin lanes.
4. Talk to the Leader. Open Mind (⌘4), or phm leader say "focus: …";
phm comms setup-telegram adds a two-way Telegram line.
5. Inspect autonomy preparation with phm authority setup --dry-run --json
and phm authority status. Autonomy ships dormant and is macOS-only —
see Autonomy.
An optional local fast lane — phm local-runtime start --slots 4 plus
ASHLRVERSELOCALDISPATCH=llama-server in the workbench environment —
sends local turns to llama-server; model discovery stays on Ollama.
Actual compiled 3.24.3 browser UI with labeled Demo accounts, a sample
conversation and an illustrative Leader memo; the newest checked-in
screenshots. No provider ran and no fleet was active. Verification, merge
and production are separate records; CI is unknown and release/deployment is
unrecorded. These screenshots show the browser UI, not native app chrome.
## What it is
Phantom brings supported coding agents, accounts and local models into
one workbench. Connect eligible Claude Code, Codex, Grok or Devin accounts,
configure an API resource, or use a tool-capable local model. Choose a