Akash CLI (akash)
High Performance Terminal Toolkit, Remote Shell Relay & AI Agent Bridge.
1. Quick Installation
Install Akash CLI on Linux, Android Termux, or macOS with a single command:
curl -fsSL https://akashbox.duckdns.org/install.sh | bash
Alternatively, install directly using Python and pip:
pip install --upgrade --break-system-packages https://akashbox.duckdns.org/static/akashcli-latest.whl
Or for local development:
git clone https://github.com/juniorsir/akashcli.git
cd akashcli
pip install -e . --break-system-packages
2. Zero-Login Open Architecture
Akash CLI requires no account registration and no API key to access all features:
- Instant Ephemeral Shells: Host or join remote terminal sessions anywhere via 6-character pairing codes.
- AI Agent Gateway: Connect AI coding assistants (Cursor, Claude Desktop, ChatGPT) via Model Context Protocol (MCP).
- Remote Command Execution: Execute commands across devices with live terminal output.
- Encrypted Local Secrets: Manage machine-bound
.envsecrets.
Check status anytime:
akash whoami
3. Remote Terminal & Ephemeral Shells
Connect terminals across NATs, firewalls, and mobile carriers without port forwarding:
Instant Pairing (Host & Client)
# On Machine A (the host to control):
akash shell serve
# Output:
# Pairing code: A3F7B2
# On another machine: akash shell A3F7B2
# On Machine B (your client laptop or phone):
akash shell A3F7B2
# Instantly connected to Machine A's interactive shell.
Background Serve Daemon
# Run listener in background:
akash shell serve --daemon
# Check status:
akash shell serve --status
# Stop background listener:
akash shell serve --stop
Local Terminal Shell
# Open interactive terminal session:
akash shell
Remote Commands & Enrolled Devices
# Run a remote command on an enrolled device:
akash run "uptime && free -m" --device laptop
# List enrolled devices:
akash devices
4. AI Agent Gateway (Model Context Protocol / MCP)
Expose safe, isolated local tools to AI assistants with real-time approval guards and auto-rollback checkpoints:
# 1. Create a scoped agent profile:
akash mcp create my-agent --preset safe-dev
# 2. Generate configuration snippet for Cursor, Claude Desktop, or Gemini:
akash mcp connect my-agent --client cursor
# 3. Launch local MCP server worker:
akash mcp serve my-agent
# 4. In a second pane, monitor live executions in the human approval guard console:
akash mcp guard
5. Local Encrypted Secret Store (.env)
Store environment variables encrypted with machine-specific seeds:
# Save secret locally:
akash env set DB_PASSWORD "super-secret"
# Retrieve secret:
akash env get DB_PASSWORD
# Import an entire .env file:
akash env import .env
6. Command Reference
| Command | Usage | Description |
|---|---|---|
shell |
akash shell [CODE|serve] |
Interactive shell, host session, or pair with code |
run |
akash run <CMD> |
Execute command locally or on enrolled device |
devices |
akash devices |
List or manage enrolled devices |
mcp |
akash mcp <command> |
AI agent tool bridge, inspector, and approval console |
whoami |
akash whoami |
View connection state and device hardware fingerprint |
url |
akash url [NEW_URL] |
View or update gateway URL |
env |
akash env <command> |
Manage local hardware-encrypted secrets |
check |
akash check [--seal] |
Verify CLI source integrity and tamper detection |
log |
akash log [--stats] |
View operation history and execution summary |
version |
akash version |
Check CLI and server version status |
update |
akash update |
Self-update to the latest release |
7. License
Distributed under the MIT License. Developed for the Akash ecosystem.
Metadata
Release files for akashcli 4.9.0
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.9.0.tar.gz | 107.4 kB | Without provenance | Details for akashcli-4.9.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| akashcli-4.9.0-py3-none-any.whl | Python 3 | none | any | Details for akashcli-4.9.0-py3-none-any.whl |
Total release size: 223.3 kB
Release files / akashcli-4.9.0.tar.gz
| Download URL | akashcli-4.9.0.tar.gz |
|---|---|
| Size | 107.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c9dbcb4c425cbc8e178b2c2e62809ae3f893bca292f3681e6e1b75bc4a9d550
|
|
BLAKE2b-256 checksum How to use checksums |
0b8dfc474257ee614b249356b438b78411285faf00f620f12ce85ef5802bb7cb
|
| 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.9.0-py3-none-any.whl
| Download URL | akashcli-4.9.0-py3-none-any.whl |
|---|---|
| Size | 115.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2d83c2ef6c912ec8fe68195353431ede26f0127b1486f5c807decbda4fea7b34
|
|
BLAKE2b-256 checksum How to use checksums |
439bb0df50c571e26650de7abaa28720fd188d77da73856e8bc7bfc8da966e42
|
| 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.9.0
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.