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


Release history Release notifications | RSS feed

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.97.tar.gz (301.9 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.97-py3-none-any.whl (284.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: entelligence_cli-0.1.97.tar.gz
  • Upload date:
  • Size: 301.9 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.97.tar.gz
Algorithm Hash digest
SHA256 2e4c951642fd244c5341d8e456929967471d8bdd64c6eb0376cfc1318a34bae5
MD5 53c583b06b849be3aaac154b42c54eee
BLAKE2b-256 b735a8e2d24b3d37188a45b2ed672fb40cd2405f047dc4150d35d9d6f30ec556

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for entelligence_cli-0.1.97-py3-none-any.whl
Algorithm Hash digest
SHA256 501a85c2ed4da563dea59a6b24ffb4570fad5f7e179c8e23bb165b2f5936a02e
MD5 4ed63b0f6248fea1b6c6deaf8214b664
BLAKE2b-256 97d96ffb35d85b7dad02cc1466a8ac3ae9866b81ea07130da6071a29b8b0a236

See more details on using hashes here.

Provenance

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