CLI — Ghosty from your terminal

ghosty is the official Ghosty Studio CLI. It does what the dashboard does (configure, test and chat with your agents) from the terminal, and it is built so your coding agent (Claude Code, Codex, Cursor) can use it too.

Install

Requires Node 22 or newer.

Sign in

ghosty login

Your browser opens, you sign in with your Ghosty account (Google, Apple or email) and the terminal is signed in. If you already have a session on ghosty.studio, opening the link is all it takes.

• If the browser doesn't open, the terminal prints the link so you can copy it.
• The session renews itself; it lasts 90 days without use before asking you to sign in again.
• Run any command without a session and the login starts on its own.
• Over SSH or on another machine? ghosty login --device gives you a link and a code to authorize from your phone (over SSH it does this by itself).
• ghosty whoami shows which account you are using; ghosty logout signs out and revokes the session.

Let your coding agent do it

Ask Claude Code to "sign in to Ghosty with the CLI". It runs ghosty login, hands you the link in the chat, you open it, and it carries on. Details in CLI for coding agents.

First steps

ghosty agents ls                        # your agentsghosty try <agent-id> "hi, who are you?"  # one test turnghosty chat <agent-id>                  # live conversation

Every command, with examples, in the command reference.

Where the session lives

In ~/.config/ghosty/config.json, readable only by your user. To point at another server, set GHOSTY_URL.