Metadata-Version: 2.4
Name: entelligence-cli
Version: 0.1.20
Summary: AI-powered code review assistant for your terminal - Get instant, intelligent feedback on your code changes
Author-email: EntelligenceAI <info@entelligence.ai>
Project-URL: Homepage, https://entelligence.ai
Project-URL: Documentation, https://docs.entelligence.ai
Keywords: code-review,ai,artificial-intelligence,cli,git,code-analysis,developer-tools,productivity,entelligence
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Code Generators
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: Programming Language :: Python :: 3.13
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: ruff>=0.8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"

# EntelligenceAI CLI

AI-powered code review assistant that helps you catch bugs, improve code quality, and follow best practices - all from your terminal.

[![PyPI version](https://badge.fury.io/py/entelligence-cli.svg)](https://pypi.org/project/entelligence-cli/)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

## 🚀 Installation

### From PyPI

```bash
pip install entelligence-cli
```

### From Source (this repo)

```bash
# Clone the repo and install in editable mode
git clone https://github.com/Entelligence-AI/cli.git
cd cli
uv tool install --editable .
```

If `uv` is not installed:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

### Uninstall

```bash
uv tool uninstall entelligence-cli
```

## 📝 Quick Start

### 1. Get Your API Key

Sign up and get your API key: [app.entelligence.ai/settings?tab=api](https://app.entelligence.ai/settings?tab=api)

### 2. Authenticate

```bash
entelligence auth login
```

Paste your API key when prompted.

### 3. Review Your Code

```bash
entelligence review
```

That's it! The CLI will analyze your uncommitted changes (or committed changes if none) and provide intelligent feedback.

## 📖 Usage

### Authentication Commands

```bash
# Log in with your API key
entelligence auth login

# Check authentication status
entelligence auth status

# Log out
entelligence auth logout
```

### Review Commands

```bash
# Review current changes (default: uncommitted, falls back to committed)
entelligence review

# Review only committed changes vs base branch
entelligence review --committed-only

# Review against a specific branch
entelligence review --base-branch develop

# Set review priority
entelligence review --priority high

# Verbose output mode
entelligence review --mode verbose

# Plain text output
entelligence review --plain

# Debug mode
entelligence review --debug
```

### Common Workflows

**Before Committing:**
```bash
git add .
entelligence review
git commit -m "Your message"
```

**Before Creating PR:**
```bash
git checkout -b feature/my-feature
# ... make changes ...
entelligence review --priority high
git push origin feature/my-feature
```


## 🔧 Configuration

### Config File

Configuration is stored at `~/.entelligence/config.json` with secure permissions (read/write for owner only).

### Environment Variables

For non-interactive use, you can set:

- `ENTELLIGENCE_API_KEY` - Your API key (alternative to `entelligence auth login`)

## 💡 Benefits

### For Individual Developers
- Catch bugs before they reach code review
- Learn best practices through AI suggestions
- Save time on code reviews
- Improve code quality consistently

### For Teams
- Maintain consistent code standards
- Reduce code review time
- Improve code quality across the team

## 🆘 Troubleshooting

### Authentication Failed

```bash
# Check your authentication status
entelligence auth status

# If invalid, re-authenticate
entelligence auth logout
entelligence auth login
```

Ensure your API key is valid at [app.entelligence.ai/settings?tab=api](https://app.entelligence.ai/settings?tab=api)

### Connection Timeout

- Check your internet connection
- Try again with `--debug` flag for more information

### No Changes Detected

```bash
# Check what changes are available
git status

# Review only committed changes if you have commits on your branch
entelligence review --committed-only

# Or review against a different base branch
entelligence review --base-branch develop
```

## 📚 Resources

- **Website**: [entelligence.ai](https://entelligence.ai)
- **Documentation**: [docs.entelligence.ai](https://docs.entelligence.ai)
- **Support**: [info@entelligence.ai](mailto:info@entelligence.ai)

## 📄 License

Proprietary - Copyright © 2026 EntelligenceAI. All rights reserved.

## ❓ FAQ

**Q: Is my code stored on your servers?**
A: No, code is only analyzed transiently and not permanently stored.

**Q: Does this work with private repositories?**
A: Yes, all code remains private and secure.

**Q: What languages are supported?**
A: Python, JavaScript, TypeScript, Java, Go, Rust, C++, Ruby, PHP, Swift, Kotlin, and more.

**Q: Can I review specific files only?**
A: Currently reviews are based on Git changes. File-specific reviews coming soon.

---

Made with ❤️ by [EntelligenceAI](https://entelligence.ai)
