Metadata-Version: 2.4
Name: entelligence-cli
Version: 0.1.183
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: tomlkit<1,>=0.13
Requires-Dist: pydantic<3,>=2.12
Requires-Dist: typing-extensions>=4.5
Requires-Dist: jinja2>=3.1
Requires-Dist: dulwich>=0.21
Requires-Dist: pydantic-ai<1.95,>=1.14
Requires-Dist: pydantic>=2.6
Requires-Dist: detect-secrets>=1.5
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.

**Onboarding is two commands.** `sync` sets up both lanes: it processes your
sessions locally and pushes the computed session + task metrics (the breadth
lane, which every dashboard number is built from), and it installs the
recurring background jobs so it keeps happening automatically. One of those
jobs is the raw (redacted) transcript upload — the depth lane, used for
decisions, replay and byte-derived pricing — which runs on its own daily
schedule rather than inline, and only for orgs whose backend posture asks for
it. The transcript itself is never uploaded by the `sync` run you type.

```bash
entelligence auth login
entelligence insights sync
```

Narrowing flags if you need them: `--transcripts` runs the transcript upload
on its own (this is what the scheduled depth-lane job invokes); `--metrics-only`
is the explicit spelling of what a plain `sync` already does, kept for scripts
that state it. Everything is redacted client-side before upload.

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