Practical overview
When it fits
Use Ghostly when you want messaging, calls or file exchange paired with wallet and identity functions, or when you need a CLI engine for bots and scripts.
Who it is for
- People who want direct, encrypted messaging with calls and file sharing.
- Users who want wallet functions or identity proofs alongside chat.
- Developers building bots, scripts or agents that use the Ghostly CLI.
Documented uses
- Start a chat by sharing an invite code, link or QR.
- Make peer-to-peer voice or video calls and exchange resumable files.
- Create private groups or link-joined communities.
- Pay in a chat using a supported wallet option.
- Present identity claims for contacts to check in the app.
Requirements & limits
The project offers browser access, desktop releases for macOS, Windows and Linux, browser extensions for Chrome, Brave and Edge, and a CLI. The CLI requires Node 22.12 or newer. The project says no account is required.
- Discovery uses the Mainline DHT; communication uses WebRTC, Iroh or HyperDHT, with the DHT as fallback.
- Private groups support up to 32 people; communities support up to 256.
- The wallet lists Cashu, Lightning, Ark, Spark, Fedimint, on-chain and USDT; mainnet is marked experimental.
- The code is TypeScript and licensed under MIT.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the Ghostly CLI
Install Ghostly’s command-line client for bots and scripts.
Before you start
- Node.js 22.12 or newer.
Steps
Install the CLI with the command below.
npm install -g @ghostlytools/cliUse the
ghostlycommand name for the installed client.
Expected outcome
The Ghostly CLI is installed and available as `ghostly`.
Guide limitations
- The CLI is for bots and scripts and runs without a screen.
- The older Rust
ghostly-clifor v0.4 chats was removed after 1.0; bots using it should move to the currentghostlyCLI.
Start a Ghostly CLI profile and create an invite
Bring a CLI profile online and create an invite that opens in the Ghostly app.
Before you start
- Ghostly CLI installed; Node.js 22.12 or newer.
Steps
Start the profile in the background with
ghostly daemon --detach.Create an invite with
ghostly invite create --label casper.Use the returned invite code or link to invite a contact.
Expected outcome
The profile is kept online and the invite command returns an invite code and link.
Guide limitations
- The CLI documentation describes invites and chat over the app’s transports; direct DHT reading is listed as planned, with relays used for now.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 11 October 2026
- Original website title
- MiguelMedeiros/ghostly · Official homepage title · retained in its source language

