0x0-messenger

# 0x0 Messenger

Install once: `npm install -g @0x0contact/c0x0` and `c0x0 init`

For full docs: https://0x0.contact

## Check your identity

```bash
c0x0 whoami          # your number + active PINs
```

## Create a PIN and share it

```bash
c0x0 pin new --label "for humans"     # creates e.g. "a3f9"
c0x0 pin new --expires 1h             # one-time use, auto-expires
c0x0 qr a3f9                          # print QR code — human scans with mobile app
```

Share as: `0x0://0x0-816-8172-8198/a3f9`

## Send a message

```bash
c0x0 send 0x0-293-4471-0038 a3f9 "build passed, ready to deploy"
```

Queues for 72h if peer is offline.

## Notify a human and wait for approval

```bash
c0x0 pipe 0x0-293-4471-0038 a3f9
```

Stdin/stdout JSON protocol:
```json
{"type": "message", "content": "deploy to prod? (yes/no)"}
{"type": "disconnect"}
```
```json
{"type": "connected", "peer": "0x0-293-4471-0038", "pin": "a3f9"}
{"type": "message", "from": "0x0-293-4471-0038", "content": "yes"}
```

## Listen for incoming messages

```bash
c0x0 listen          # waits on all active PINs, emits JSON events
c0x0 inbox --json    # check inbox without connecting
c0x0 read a3f9       # read message history for a PIN
```

## Let a human connect via browser or mobile

```bash
c0x0 web             # browser UI at localhost:3000
c0x0 web --lan       # expose on LAN — human opens on phone
```

Human can also use the Android app (Google Play) or iOS app to connect to your number + PIN.

## Receive from anyone (public PIN)

```bash
c0x0 pin new --public --label "inbox"   # share this PIN openly
c0x0 requests                            # list incoming threads
c0x0 approve <pin> <shortKey>            # reply → private channel created
```

## Contacts

```bash
c0x0 contact add 0x0://0x0-293-4471-0038/a3f9
c0x0 contact list
```

## Revoke when done

```bash
c0x0 pin revoke a3f9
```

# 0x0

> P2P disposable number messenger — no servers, no logs, no trace.

Share a number and a PIN. Message. Forget it ever happened.

---

## install

```bash
npm install -g @0x0contact/c0x0
```

requires Node.js 18+

---

## quick start

```bash
# initialize (generates your number)
c0x0 init

# --- share your number + PIN with someone ---
c0x0 pin new --label "for sale"   # creates e.g. "a3f9"
c0x0 whoami                       # shows your number to share

# --- or connect to someone who shared their number + PIN ---
c0x0 chat 0x0-293-4471-0038 a3f9

# done — revoke your PIN when finished
c0x0 pin revoke a3f9
```

---

## commands

### setup

```bash
c0x0 init          # generate your number
c0x0 whoami        # show your number
c0x0 renew         # generate a new number (resets all PINs)
```

### PIN management

```bash
c0x0 pin new                          # create a PIN
c0x0 pin new --label "label"          # with label
c0x0 pin new --expires 24h            # expires in 24h (also: 1w)
c0x0 pin new --public                 # create a public PIN (for requests)
c0x0 pin list                         # list all PINs
c0x0 pin rotate <pin>                 # change PIN value
c0x0 pin revoke <pin>                 # permanently revoke
```

### messaging

```bash
c0x0 chat <number> <pin>              # interactive chat
c0x0 send <number> <pin> "message"    # send once and exit
c0x0 inbox                            # view all inboxes
c0x0 read <pin>                       # read messages for a PIN
c0x0 listen                           # wait for incoming messages
c0x0 queue                            # show offline message queue
```

### requests (public PIN)

Share a public PIN openly — anyone can message you without knowing your number.
First reply creates a dedicated private channel automatically.

```bash
c0x0 pin new --public --label "open"  # create a public PIN to share
c0x0 requests...