Skip to main content

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 .env secrets.

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)

Source distribution for akashcli 4.9.0
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)

Table of built distributions (wheels) for akashcli 4.9.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

4.9.0 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