Installing the `firecloud` executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install firecloud-cli

It will make the firecloud command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall firecloud-cli uninstalls.

Back to the crate overview.

Readme

firecloud-cli

Command-line interface for FireCloud P2P messaging and file sharing.

Overview

The firecloud binary provides a complete CLI for:

P2P messaging: Private, metadata-hiding chat
Friend management: Add, accept, and manage friends
File sharing: Upload and download files across the P2P network
Background daemon: Run node in the background

Installation

cargo install firecloud-cli

Quick Start

# Initialize identity
firecloud init

# Start node in background
firecloud node --daemon

# Add a friend
firecloud friend add <peer-id> --name "Alice"

# Send a message
firecloud msg send Alice "Hello!"

# View inbox
firecloud msg inbox

Commands

Node Management

firecloud node - Start P2P node (use --daemon for background)
firecloud init - Generate identity keypair

Friend Management

firecloud friend add <peer-id> - Add a friend
firecloud friend accept <peer-id> - Accept friend request
firecloud friend list - List all friends
firecloud friend pending - Show pending requests

Messaging

firecloud msg send <friend> <text> - Send message (1KB padded)
firecloud msg inbox - View received messages
firecloud msg chat <friend> - View conversation

firecloud upload <file> - Upload and share a file
firecloud download <hash> - Download a file
firecloud list - List uploaded files

Privacy Features

Metadata hiding: All messages padded to 1024 bytes
Timing obfuscation: Random delays (100-500ms)
Friend verification: Only friends can message you
End-to-end encryption: Coming soon

Daemon Mode

Run the node in the background:

# Start daemon
firecloud node --daemon

# View logs
tail -f ~/.local/share/firecloud/node.log

# Stop daemon
kill $(cat ~/.local/share/firecloud/node.pid)

License

Licensed under either of:

Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Installing the firecloud executable

Installing the `firecloud` executable