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.62.tar.gz (128.0 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.62-py3-none-any.whl (123.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: entelligence_cli-0.1.62.tar.gz
  • Upload date:
  • Size: 128.0 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.62.tar.gz
Algorithm Hash digest
SHA256 c73626d9c6affb36af2c7561a85110d53c2d87fce4cbde3e2f28149e2ed6ffcf
MD5 2fa8693730103beabd64e5395f592313
BLAKE2b-256 48de775e808610549fb546541bcfafa21bc908cfa7b2dca262de8f4b090741af

See more details on using hashes here.

Provenance

The following attestation bundles were made for entelligence_cli-0.1.62.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.62-py3-none-any.whl.

File metadata

File hashes

Hashes for entelligence_cli-0.1.62-py3-none-any.whl
Algorithm Hash digest
SHA256 baf30820ded8b5f0a378143a632a697b2d8dea3b19ee7e1b4af0bdfb5d5b6d20
MD5 9437026bfaf37a68d750a98830cab98e
BLAKE2b-256 f2803e1950d3d95c6ec73b529c58ce14395a674a7d996954061a918720e1b34b

See more details on using hashes here.

Provenance

The following attestation bundles were made for entelligence_cli-0.1.62-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