Metadata-Version: 2.4
Name: debugtwin-cli
Version: 1.0.1
Summary: DebugTwin Copilot CLI - AI-powered firmware debugging assistant
Author-email: Frozo <support@frozo.io>
License: MIT
Project-URL: Homepage, https://github.com/ashish-frozo/embedded-client
Project-URL: Documentation, https://embedded-frontend-production.up.railway.app
Project-URL: Repository, https://github.com/ashish-frozo/embedded-client
Keywords: firmware,debugging,embedded,ai,copilot,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Embedded Systems
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: rich>=13.0.0

# DebugTwin CLI

AI-powered firmware debugging assistant for embedded systems.

## Installation

```bash
pip install debugtwin-cli
```

## Quick Start

### 1. Get an API Key

1. Go to [DebugTwin Dashboard](https://embedded-frontend-production.up.railway.app)
2. Sign in with Google
3. Navigate to **API Keys** in the header
4. Click **Generate Key** and copy it

### 2. Login

```bash
debugtwin login --key YOUR_API_KEY
```

### 3. Start Chatting

```bash
debugtwin chat
```

### 4. Analyze a Log File

```bash
debugtwin analyze your_firmware.log
```

## Commands

| Command | Description |
|---------|-------------|
| `debugtwin login --key KEY` | Authenticate with your API key |
| `debugtwin chat` | Start an interactive debugging session |
| `debugtwin analyze FILE` | Analyze a firmware log file |
| `debugtwin ask "question"` | Ask a quick question |
| `debugtwin version` | Show version information |
| `debugtwin configure --url URL` | Configure custom API URL (for self-hosted) |

## Example Session

```
$ debugtwin chat
🚀 Starting DebugTwin Copilot CLI...
🔌 Connecting to: https://web-production-5988.up.railway.app

🤖 Hello! How can I help you debug your firmware today?

You: I'm seeing a HardFault on my STM32F4
🤖 I'd be happy to help debug that HardFault! Can you share:
1. The crash log or register dump
2. What was happening when it occurred
...
```

## Requirements

- Python 3.9+
- Internet connection (for API access)

## License

MIT
