Metadata-Version: 2.4
Name: entelligence-cli
Version: 0.1.32
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.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: rich<14.0,>=13.0.0
Requires-Dist: entelligence-insights[server]>=0.1.12
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
```

### Auto-update

The CLI keeps itself up to date automatically. On any command it checks PyPI
(at most once per day) and, when a newer version exists, upgrades in place using
your install method (`uv tool` / `pipx` / `pip`) and re-runs your command on the
new version. Auto-update is skipped for non-interactive/piped output, CI, and
editable/dev installs, where it instead prints a one-line "update available" notice.

To opt out (e.g. pinned or centrally managed installs), set the env var or config flag:

```bash
export ENTELLIGENCE_NO_AUTO_UPDATE=1
# or, in ~/.entelligence/config.json:  { "auto_update": false }
```

## 📝 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
```

### Insights Commands

Coding-agent analytics powered by [cinsights](https://github.com/deepankarm/cinsights).
Every `cinsights <cmd>` is available as `entelligence insights <cmd>`. It reads
your local Claude Code / Codex session files, scores them, and (optionally)
runs LLM analysis to surface friction patterns, per-project digests, and
per-developer profiles.

```bash
# One-time: configure the LLM provider (saved to ~/.cinsights/config.json)
entelligence insights setup

# Index local sessions (free, no LLM calls)
entelligence insights index --source local --hours 8760

# Analyze sessions (shows a cost estimate and asks for confirmation)
entelligence insights analyze --source local

# Generate a project or developer digest
entelligence insights digest project <my-project> --days 30
entelligence insights digest user <user-id> --days 30

# Launch the local web dashboard (http://localhost:8100)
entelligence insights serve

# Full subcommand list and flags
entelligence insights --help
```

### 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)
