Skip to main content

AI-powered code review assistant for your terminal - Get instant, intelligent feedback on your code changes

Project description

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 Python 3.8+

🚀 Installation

From PyPI

pip install entelligence-cli

From Source (this repo)

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

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

Uninstall

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:

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

2. Authenticate

entelligence auth login

Paste your API key when prompted.

3. Review Your Code

entelligence review

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

📖 Usage

Authentication Commands

# Log in with your API key
entelligence auth login

# Check authentication status
entelligence auth status

# Log out
entelligence auth logout

Review Commands

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

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

git add .
entelligence review
git commit -m "Your message"

Before Creating PR:

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

# 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

Connection Timeout

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

No Changes Detected

# 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

📄 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

entelligence_cli-0.1.45.tar.gz (116.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

entelligence_cli-0.1.45-py3-none-any.whl (113.2 kB view details)

Uploaded Python 3

File details

Details for the file entelligence_cli-0.1.45.tar.gz.

File metadata

  • Download URL: entelligence_cli-0.1.45.tar.gz
  • Upload date:
  • Size: 116.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for entelligence_cli-0.1.45.tar.gz
Algorithm Hash digest
SHA256 0772f71965268266a85447058cb94c13a988e6836cca8fca366de095611a27e7
MD5 429bc25c7fce5386ba1d90d8dd652117
BLAKE2b-256 5c3222d75739dcda00db6ffe154ec9e96d625dd90bd8408646a1676bbc174ba8

See more details on using hashes here.

Provenance

The following attestation bundles were made for entelligence_cli-0.1.45.tar.gz:

Publisher: publish.yml on Entelligence-AI/cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file entelligence_cli-0.1.45-py3-none-any.whl.

File metadata

File hashes

Hashes for entelligence_cli-0.1.45-py3-none-any.whl
Algorithm Hash digest
SHA256 2d4add8eb85dfe9017122e165cc1bd4b08a0b4c08a2d91775bcc717fe99f81d0
MD5 12f266700dcdd87add859b959220a25e
BLAKE2b-256 6a414842c0f457e01cec832809644b43af3363917806edcce5f073ce3218e923

See more details on using hashes here.

Provenance

The following attestation bundles were made for entelligence_cli-0.1.45-py3-none-any.whl:

Publisher: publish.yml on Entelligence-AI/cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page