Skip to main content

⚡ Akash CLI (akash)

Encrypted Cloud Vault · Remote Terminal Relay · AI Agent Tool Bridge

Python Version Security Protocol License

The developer-first CLI for instant environment backups, zero-setup remote terminals, encrypted peer-to-peer file transfers, and safe AI agent execution.


📖 Easy Master Guide • Quickstart • Core Features • Zero-Login Guest Mode • 💖 Sponsoring • Documentation • Command Matrix


🌟 Why Akash CLI?

Modern developer workflows demand flexibility across multiple machines — laptops, cloud servers, and mobile environments like Android Termux. Akash CLI solves daily pain points with a unified, secure toolkit:

  • 🖥️ Remote Shell Anywhere: Connect to any remote device or share an interactive terminal session in seconds across firewalls and NATs.
  • 💾 Instant Environment Snapshots: Backup dotfiles, shell configs, and package inventories with automated secret scrubbing and 1-click restore.
  • ☁️ Encrypted Cloud Vault: Store files, stream video directly into VLC, and pipe shell outputs without writing to disk.
  • 🔐 P2P Zero-Knowledge Transfers: Send end-to-end encrypted files to other users using X25519 ECDH — even the storage server cannot inspect them.
  • 🔒 Hardware-Bound .env Store: Manage local and cloud-synced environment variables encrypted with machine-specific seeds.
  • 🤖 AI Agent Gateway (MCP): Safely expose local tools to Cursor IDE and Claude Desktop with real-time terminal approval guards and auto-undo checkpoints.

🚀 Quickstart in 60 Seconds

1. Installation

# Clone and install in editable mode:
git clone https://github.com/juniorsir/akashcli.git
cd akashcli
pip install -e . --break-system-packages

2. Connect Your Machine

Obtain an API key from the Akash Telegram Bot (go to 👤 My Account ➔ 🔑 Generate API Key), then run:

akash login --label "laptop"

(Alternatively, explore without logging in using Guest Mode!)

3. Check Account Status

akash whoami

🤝 Zero-Login Guest Mode

Need to pair two machines instantly without an account or API key?

# On Machine A (Host):
akash serve --share
# ➔ Generates pairing code: A3F7B2

# On Machine B (Client):
akash shell --code A3F7B2
# ➔ Instantly connected to Host's interactive terminal!

⚡ Core Features

1. 💾 Environment Backups & Disaster Recovery

Capture your entire shell setup and restore it on any machine in seconds:

# Save your terminal configuration to cloud (or local file with -o):
akash backup --label "workstation"

# Restore on a new computer (zero login required):
akash pull 8k9F2a

# Restore from cloud code or local archive:
akash restore 8k9F2a
akash restore ~/my_backup.tar.gz

# Preview what will be extracted before touching disk:
akash restore 8k9F2a --dry-run
akash restore 8k9F2a --tree
  • Auto Secret Scrubbing: Redacts tokens, passwords, and private keys from history files.
  • Bloat Pruning: Skips node_modules, __pycache__, and .venv.
  • Package Manifests: Inventories apt, brew, pip, npm, cargo for auto-reinstallation.

2. 🖥️ Remote Shells & Persistent Devices

Manage your fleet of servers and workstations:

# Run listener on your phone or remote server:
akash serve --daemon --label termux

# Open interactive shell from your laptop:
akash shell --device termux

# Run individual command remotely:
akash run "uptime" --device termux

3. ☁️ Cloud File Vault & Streaming

# Upload a file with 7-day auto-expiry:
akash cloud upload my_doc.pdf --expiry 7

# One-time burn-after-read:
akash cloud upload --burn secret_report.pdf

# Stream video directly into VLC without downloading:
akash cloud stream 7xY3a0 --vlc

# Pipe command output directly into the cloud vault:
mysqldump -u root db | akash pipe -n "db_backup.sql"

4. 🔐 P2P Encrypted File Transfers

Zero-knowledge file exchange using Curve25519 / X25519:

# View your public key and fingerprint:
akash id

# Send encrypted file to a contact:
akash send bob sensitive_dataset.zip -m "Q3 dataset"

# Recipient receives and decrypts:
akash inbox
akash inbox 7qR92x

5. 🔒 Hardware-Encrypted .env Store

# Set secrets into encrypted store:
akash env set prod DATABASE_URL="postgresql://user:pass@host/db"

# Retrieve secret for automation:
akash env get prod DATABASE_URL --raw

# Push encrypted secrets to cloud vault with burn-on-read:
akash env push prod --burn

# Pull secrets onto remote server:
akash env pull eX481p prod

6. AI Agent Gateway (MCP) & Guard Console

Supercharge Cursor and Claude Desktop with local terminal execution, protected by real-time human approval:

        ╭─────╮
     ╭──╯     ╰──╮   AKASH MCP
    (    M C P    )  Model Context Protocol · Claude · Cursor · Codex
     ╰───────────╯
# 1. Create agent profile with safe role preset:
akash agent create --name "Cursor" --role @coder

# 2. Generate configuration snippet for Cursor / Claude Desktop:
akash mcp share --claude --temp 30m

# 3. Start local tool execution worker with auto-undo checkpoints:
akash mcp serve

# 4. In a separate terminal, open live approval console:
akash guard

📚 In-Depth Documentation Guides

Explore comprehensive guides in the docs/ directory:

Document Topic Covered
01. Quickstart & Installation Setup on Linux, macOS, Windows, Android Termux / PRoot, and troubleshooting
02. Remote Terminal & Relays WebSocket relay, 1-click guest pairing, background daemons, remote execution
03. Environment Backups Dotfile snapshots, secret scrubbing, visual tree explorer, package recovery
04. Cloud Vault & Streaming Uploads, burn-after-read, direct VLC streaming, Unix pipe streaming
05. P2P Encrypted Transfers X25519 ECDH asymmetric encryption, zero-knowledge storage, inbox management
06. Secrets & .env Vault Local encrypted store, .env file import/export, cloud push/pull sync
07. AI Agents & MCP Model Context Protocol, Claude/Cursor integration, terminal guard approvals
08. Security & Integrity Audit Hardware machine keys, SHA-256 HMAC code integrity sealing, audit logs
09. Full Command Reference Exhaustive command cheat-sheet with every argument, flag, and option

📊 Command Matrix

akash
 ├── sponsor         💖 Information on sponsoring & bringing back storage nodes
 ├── login           Connect API key with hardware binding
 ├── whoami          Account quota & device fingerprint
 ├── backup          Save terminal environment to cloud or local archive
 ├── restore         Restore environment (with --tree, --explore, --dry-run)
 ├── saves           List cloud-saved terminal snapshots
 ├── shell           Open interactive PTY (local, remote device, or guest code)
 ├── run             Execute command remotely or save output to vault
 ├── serve           Make device reachable (--daemon, --share for guest mode)
 ├── devices         List, authorize, or revoke enrolled machines
 ├── cloud
 │    ├── upload     [DISCONTINUED] Upload file (run 'akash sponsor' for details)
 │    ├── files      List vault files
 │    ├── stream     Direct streaming link or launch in VLC
 │    ├── bulk       [DISCONTINUED] Recursively upload directory
 │    └── delete     Purge file permanently
 ├── pipe            [DISCONTINUED] Upload stdin directly to cloud
 ├── send            End-to-end encrypted P2P transfer to user public key
 ├── inbox           Receive and decrypt incoming P2P files
 ├── id              View or export P2P identity key and manage contacts
 ├── env
 │    ├── list       List env stores or keys
 │    ├── set        Add or update key-value secret
 │    ├── get        Retrieve secret (--raw for scripting)
 │    ├── import     Import .env file into encrypted store
 │    ├── export     Export encrypted store to .env
 │    ├── push       Push encrypted store to cloud vault
 │    └── pull       Pull and restore env store on new machine
 ├── agent
 │    ├── create     Generate agent profile (Client ID + Secret + Scopes)
 │    ├── list       List agent profiles
 │    └── revoke     Revoke agent access
 ├── mcp
 │    ├── serve      High-reliability MCP worker with undo checkpoints
 │    ├── share      Generate configuration snippet for Claude & Cursor
 │    ├── guard      Interactive terminal approval console
 │    └── status     One-glance MCP gateway status
 ├── check           Verify package source integrity (--seal to update)
 └── log             Operational audit log (--stats for graphic summary)

🛡️ Security & Privacy Architecture

Akash CLI enforces security at every layer:

  1. Zero-Knowledge P2P Transfers: Files are encrypted with X25519 and AES-256-GCM before leaving your device.
  2. Machine-Bound Secrets: Local tokens, .env stores, and keys are tied to a unique ~/.akash/machine.key that cannot be copied to other systems.
  3. Automated Secret Sanitization: Sensitive variables, connection strings, and tokens in shell history files are scrubbed prior to archiving.
  4. Source Tamper Detection: akash check computes cryptographic HMAC digests over package files to block malicious code modifications.

💖 Sponsorship & Restoring Storage Services

Akash CLI is an independent, community-driven open-source project. We previously provided free, high-speed public file uploading, sharing, and native media streaming. However, due to mounting NVMe cloud server expenses, bandwidth costs, and a lack of operational funding, public storage and uploading services had to be discontinued.

How Your Sponsorship Helps

Your financial contribution directly funds:

  • 💽 Dedicated NVMe Storage Nodes: Restoring community cloud vault storage for backups and files.
  • 🌐 High-Bandwidth Network Transit: Low-latency global relay clusters for terminal sessions and fast file retrieval.
  • 🛡️ Long-Term Open Source Maintenance: Ongoing development for Termux, Linux, macOS, and Windows.

Ways to Sponsor & Donate


📄 License

Distributed under the MIT License. See LICENSE for details.

Metadata

Release files for akashcli 4.8.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for akashcli 4.8.6
File Size Uploaded Provenance Actions
akashcli-4.8.6.tar.gz 120.7 kB Without provenance Details for akashcli-4.8.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for akashcli 4.8.6
File Interpreter ABI Platform Actions
akashcli-4.8.6-py3-none-any.whl Python 3 none any Details for akashcli-4.8.6-py3-none-any.whl

Total release size: 246.1 kB

Release files / akashcli-4.8.6.tar.gz

Download URL akashcli-4.8.6.tar.gz
Size 120.7 kB
Tags Source
SHA-256 checksum
How to use checksums
ebacc1f68acf5df17728289a274487828ed2585fda1974e6f66cb3c850b6775f
BLAKE2b-256 checksum
How to use checksums
4918e1bf6e6b3f7558f6e1135287521c1126a3140d4c041e1b8cbb6988508dce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / akashcli-4.8.6-py3-none-any.whl

Download URL akashcli-4.8.6-py3-none-any.whl
Size 125.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ba6e804e8b97d60515bc399aa6f938792db6fab26bbaa5ed6fe610acf1869e4f
BLAKE2b-256 checksum
How to use checksums
af6240a642535933becb6f5bd79344d1ef2b000df2035d70fb638b8fab92084e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Security for akashcli 4.8.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

4.8.6 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page