⚡ Akash CLI (akash)
Encrypted Cloud Vault · Remote Terminal Relay · AI Agent Tool Bridge
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 • 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,cargofor 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:
# 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
├── 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 Upload file or secret text snippet
│ ├── files List vault files
│ ├── stream Direct streaming link or launch in VLC
│ ├── bulk Recursively upload directory
│ └── delete Purge file permanently
├── pipe Upload stdin or command output 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:
- Zero-Knowledge P2P Transfers: Files are encrypted with X25519 and AES-256-GCM before leaving your device.
- Machine-Bound Secrets: Local tokens,
.envstores, and keys are tied to a unique~/.akash/machine.keythat cannot be copied to other systems. - Automated Secret Sanitization: Sensitive variables, connection strings, and tokens in shell history files are scrubbed prior to archiving.
- Source Tamper Detection:
akash checkcomputes cryptographic HMAC digests over package files to block malicious code modifications.
📄 License
Distributed under the MIT License. See LICENSE for details.
Metadata
Release files for akashcli 4.8.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| akashcli-4.8.5.tar.gz | 118.2 kB | Without provenance | Details for akashcli-4.8.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| akashcli-4.8.5-py3-none-any.whl | Python 3 | none | any | Details for akashcli-4.8.5-py3-none-any.whl |
Total release size: 241.9 kB
Release files / akashcli-4.8.5.tar.gz
| Download URL | akashcli-4.8.5.tar.gz |
|---|---|
| Size | 118.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9cdaa0468c924f8a4c60800ce60ccf7428fb82446bfefd23ee1db35f2ae92547
|
|
BLAKE2b-256 checksum How to use checksums |
6e97a3b4e2da4669e2e544d6e1b63ecc8571e56ebceeef665ccac113373e92ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / akashcli-4.8.5-py3-none-any.whl
| Download URL | akashcli-4.8.5-py3-none-any.whl |
|---|---|
| Size | 123.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
21c6c85158aa63bc192527ac5de3debda1795a4edd69a80e48c497f00dcdb93d
|
|
BLAKE2b-256 checksum How to use checksums |
2ca3ac95e0ed643865e5d9c61487d8417d09209e9fc13042af7ce00cfbec369f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Security for akashcli 4.8.5
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.