Skip to content

mcxross/noxly

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Noxly

Noxly is an encrypted chat client for the terminal. Built for developers, operators, and power users who want private and decentralized messaging without leaving the command line.

It is built using SuiNS for identity, Walrus for Storage, Seal for encryption and Sui for coordination.

Installation

Install Noxly globally with your preferred package manager.

npm install -g noxly

Or with Bun:

bun install -g noxly

Verify the installation:

noxly --version

Quick Start

Import your Sui account:

noxly account import

Send a message:

noxly send alice "hello man"

Read messages with a user:

noxly history alice

CLI Commands

Noxly can be used entirely from the command line without opening the interactive TUI.

Messaging

Command Description
noxly send <user> "message" Send a message (auto-creates DM if needed)
noxly dm <user> "message" Alias for send
noxly history <user> List messages with a user
noxly hist <user> Alias for history
noxly channels List all conversations
noxly ch Alias for channels

User format accepts "username" or "@username" — SuiNS lookup is automatic.

Examples:

noxly send alice "hello"
noxly send @bob "hey there"
noxly history bob
noxly channels

Account Management

Command Description
noxly account list List all imported accounts
noxly account ls Alias for list
noxly account show Show active account details
noxly account switch <name> Switch to another account
noxly account import Import a Sui private key
noxly account delete <name> Remove an account

You can identify accounts by SuiNS name or address (full or partial).

Examples:

noxly account list
noxly account show
noxly account switch bob
noxly account switch 0xabc123...

Legacy Aliases

Command Equivalent to
noxly import-key noxly account import
noxly import-private-key noxly account import
noxly account import noxly account import

TUI

Start the interactive terminal UI:

noxly

Inside the app, use commands from the composer:

:dm name
:group room member member2
:add name
:file /path/to/file optional message
:sync
:help
:q

Features

  • Terminal-native encrypted messaging
  • SuiNS-based identity
  • Direct and group conversations
  • File attachments
  • Local account management with encrypted key storage
  • Keyboard-first workflow
  • CLI or TUI — use Noxly however you prefer

Why Noxly

You'll know once you need it.

Requirements

  • Node.js 20 or newer, or Bun
  • A terminal with Unicode support
  • A Sui account
  • A SuiNS profile for identity-based messaging

Development

Clone the repository:

git clone https://github.com/your-org/noxly.git
cd noxly

Install dependencies:

npm install

Run the app locally:

npm run dev

Build the package:

npm run build

Security

Noxly is designed around local account control and encrypted communication. Keep your private keys safe and never share your local configuration directory.

License

Apache License 2.0

About

A terminal-based encrypted chat client powered by Sui

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors