Metadata-Version: 2.4
Name: intent-agent
Version: 0.1.0
Summary: AI-powered CLI agent that controls your desktop with natural language commands
Author-email: Intent Team <support@intent-cli.com>
License: MIT
Project-URL: Homepage, https://github.com/intent-cli/intent-cli
Project-URL: Repository, https://github.com/intent-cli/intent-cli
Project-URL: Issues, https://github.com/intent-cli/intent-cli/issues
Keywords: cli,ai,automation,desktop,agent,intent
Classifier: Development Status :: 3 - Alpha
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openrouter>=0.1.0
Requires-Dist: pyautogui>=0.9.54
Requires-Dist: mss>=9.0.1
Requires-Dist: Pillow>=10.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: click>=8.1.7
Requires-Dist: rich>=13.7.0
Requires-Dist: requests>=2.31.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: keyring>=25.0.0
Requires-Dist: google-genai>=0.1.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Dynamic: license-file

# Intent CLI

AI-powered CLI agent that controls your desktop with natural language commands.

## Features

- Control your desktop with natural language commands
- Interactive REPL mode for continuous commands
- Authentication with Intent Web Dashboard
- Screenshot capture and analysis
- Cross-platform support (macOS, Windows, Linux)

## Installation

### From PyPI (recommended)

```bash
pip install intent-cli
```

### From source

```bash
git clone https://github.com/intent-cli/intent-cli.git
cd intent-cli
pip install -e .
```

## Usage

### Interactive Mode

Start the interactive command mode:

```bash
intent
```

This will open an interactive session where you can type natural language commands.

### Available Commands

- `help` or `h` - Show help message
- `status` - Show authentication status and credits
- `logout` - Log out and exit
- `exit` or `quit` - Exit interactive mode
- Any natural language command - Execute the command

### Authentication

Log in to your Intent account:

```bash
intent login
```

This will open your browser to complete authentication.

Check your session status:

```bash
intent status
```

### Direct Command Execution

Execute a command directly without entering interactive mode:

```bash
intent "open calculator"
intent "click the settings button"
intent "take a screenshot"
```

### Options

- `-v, --verbose` - Enable verbose output
- `-c, --confirm` - Require confirmation before execution
- `-d, --dry-run` - Generate code without executing it

## Configuration

Intent CLI uses environment variables for configuration. Copy `.env.example` to `.env`:

```bash
cp .env.example .env
```

| Variable | Description |
|----------|-------------|
| `INTENT_API_URL` | Custom API endpoint (optional) |
| `INTENT_LOG_LEVEL` | Logging level (default: info) |

## Development

Install dependencies for development:

```bash
pip install -e ".[dev]"
```

Run tests:

```bash
pytest
```

Build the package:

```bash
python -m build
```

## License

MIT License - see LICENSE file for details.
