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.39.tar.gz (111.5 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.39-py3-none-any.whl (108.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: entelligence_cli-0.1.39.tar.gz
  • Upload date:
  • Size: 111.5 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.39.tar.gz
Algorithm Hash digest
SHA256 c26b635377282935df084bb6bad49129332ad4df975054a95d410c647724b32e
MD5 d87ffedf65393ba87e4cb85c2888774c
BLAKE2b-256 86226182ceaa09a0a58b5b79ab395d7ee258be504b0fd4905debade1a9b257ec

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for entelligence_cli-0.1.39-py3-none-any.whl
Algorithm Hash digest
SHA256 db22f64f88a23ff3340075730c2bb3e93ba772e50e6bdc8515f13a25304a4991
MD5 14512b3f47579efa6dbd490d7d70b573
BLAKE2b-256 94e015cba2adfbe06577487dd4376063b4e654b63b34f525a235bf9a95d2e2f5

See more details on using hashes here.

Provenance

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