intent-agent 0.1.0

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

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)

pip install intent-cli

From source

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

Usage

Interactive Mode

Start the interactive command mode:

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:

intent login

This will open your browser to complete authentication.

Check your session status:

intent status

Direct Command Execution

Execute a command directly without entering interactive mode:

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:

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:

pip install -e ".[dev]"

Run tests:

pytest

Build the package:

python -m build

License

MIT License - see LICENSE file for details.