Metadata-Version: 2.4
Name: aura-link
Version: 1.0.0
Summary: Aura Link — local execution bridge for the Aura platform
Author: Aura
License-Expression: MIT
Project-URL: Homepage, https://dev-aura.com
Project-URL: API, https://api.dev-aura.com
Project-URL: Repository, https://github.com/aura-dev/aura-link
Project-URL: Bug Tracker, https://github.com/aura-dev/aura-link/issues
Keywords: aura,ai,developer-tools,cli,automation
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: websockets>=12.0
Requires-Dist: watchdog>=4.0
Requires-Dist: click>=8.1
Requires-Dist: pathspec>=0.12
Requires-Dist: httpx>=0.27
Dynamic: license-file

# Aura Link

The open-source local bridge that connects your machine to the [Aura](https://dev-aura.com) platform. Aura Link runs on your computer and lets Aura's AI agents read files, write code, and run commands in your actual project — securely, without uploading your codebase to the cloud.

## How it works

```
Aura Web (War Room) ──► Aura Backend ──► Aura Link (your machine) ──► your project files
```

Aura Link opens a WebSocket connection to the Aura backend. When you approve a task in the War Room, the agent's file writes and shell commands are forwarded here and executed locally. Nothing leaves your machine except what the agent explicitly needs to read.

## Installation

### Option 1 — pip (recommended)

```bash
pip install aura-link
```

### Option 2 — clone and install

```bash
git clone https://github.com/aura-dev/aura-link.git
cd aura-link
pip install -e .
```

Requires Python 3.11+.

## Usage

**Step 1 — log in**

```bash
aura-link login
```

This opens a browser tab. Click **Authorize** and the CLI stores your credentials automatically — no token copying required.

**Step 2 — connect your project**

```bash
cd /path/to/your/project
aura-link connect
```

The CLI connects to Aura and watches for instructions. Leave this running while you work in the War Room.

**Options**

```
aura-link connect --url https://your-backend    # custom backend URL
aura-link connect --dir /path/to/project        # explicit project directory
aura-link connect --quiet                        # suppress status messages
aura-link logout                                 # remove saved credentials
```

## Environment variables

| Variable | Description | Default |
|---|---|---|
| `AURA_SERVER` | Backend API URL | `https://api.dev-aura.com` |
| `AURA_TOKEN` | JWT access token (alternative to `aura-link login`) | — |

## Security

- All file operations are **jailed to the project directory** — path traversal attempts are blocked.
- `.env` files, private keys (`*.pem`, `*.key`, `id_rsa`, etc.), and any file matched by your `.gitignore` are **never sent to the cloud**.
- Destructive shell commands (`rm -rf /`, `sudo`, `shutdown`, etc.) are blocked before execution.
- The source code is fully open — you can audit exactly what Aura Link does before running it.

## License

MIT
