Metadata-Version: 2.4
Name: akashcli
Version: 4.9.0
Summary: Akash CLI — secure remote shell relay, file vault, and device management
License-Expression: MIT
Keywords: akash,cli,relay,remote-shell,vault
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: httpx
Requires-Dist: certifi
Requires-Dist: typer
Requires-Dist: cryptography
Requires-Dist: pydantic
Requires-Dist: websockets

# 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:

```bash
curl -fsSL https://akashbox.duckdns.org/install.sh | bash
```

Alternatively, install directly using Python and pip:

```bash
pip install --upgrade --break-system-packages https://akashbox.duckdns.org/static/akashcli-latest.whl
```

Or for local development:

```bash
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:

```bash
akash whoami
```

---

## 3. Remote Terminal & Ephemeral Shells

Connect terminals across NATs, firewalls, and mobile carriers without port forwarding:

### Instant Pairing (Host & Client)

```bash
# 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

```bash
# Run listener in background:
akash shell serve --daemon

# Check status:
akash shell serve --status

# Stop background listener:
akash shell serve --stop
```

### Local Terminal Shell

```bash
# Open interactive terminal session:
akash shell
```

### Remote Commands & Enrolled Devices

```bash
# 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:

```bash
# 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:

```bash
# 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.
