Skip to main content

deputy

Code intelligence CLI for Python. Parses source files with deproc, stores entities (classes, functions, imports, etc.) in a local SQLite database, and provides commands to search, inspect, and resolve symbols.

Full documentation →

Installation

pip install deputy-cli
# or: uv tool install deputy-cli

Quick start

deputy init                                    # create database
deputy sync                                    # scan & index project
deputy search "Model"                          # find entities matching regex
deputy info deputy.core.create_context          # inspect an entity
deputy resolve deputy.utils.storage.FileMetadata  # resolve through imports
deputy subclasses myapp.models.BaseModel       # find direct subclasses
deputy pin-inheritance myapp.models.Model Base models.py:10  # pin ambiguous base

Configuration

Deputy uses a key-value config file (.deputyconfig) in the project root:

deputy config enable_cache true       # cache resolution results
deputy config auto_sync true          # auto-sync before queries
deputy config display_mode tree       # tree view for search results
deputy config sync_deps true          # index .venv dependencies

Logging

deputy config log_level DEBUG         # most verbose
deputy config log_level WARNING       # default
deputy -v sync                        # one-off debug mode
deputy --quiet search "Model"         # errors only

Development

git clone https://github.com/gurveervirk/deputy
cd deputy
uv sync
uv run pytest

License

See LICENSE.

Download files

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

Source Distribution

deputy_cli-0.1.0.tar.gz (84.8 kB view details)

Uploaded Source

Built Distribution

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

deputy_cli-0.1.0-py3-none-any.whl (44.2 kB view details)

Uploaded Python 3

File details

Details for the file deputy_cli-0.1.0.tar.gz.

File metadata

  • Download URL: deputy_cli-0.1.0.tar.gz
  • Upload date:
  • Size: 84.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for deputy_cli-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a60a33ba5ccea7f4a4d35c7422d1d1130bf752b6ceebd0cc7ed70b158e249cf8
MD5 1f61eba7d37c5e77bc0a10c8ec6f4086
BLAKE2b-256 6265597463c8333998c2c2d5603f51a4b7731f4019df5b0e9c4ebe749e10db81

See more details on using hashes here.

Provenance

The following attestation bundles were made for deputy_cli-0.1.0.tar.gz:

Publisher: publish.yml on gurveervirk/deputy

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

File details

Details for the file deputy_cli-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: deputy_cli-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 44.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for deputy_cli-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 841de4fc3fd301ff940c7d498ccb0a110d86a43d78b103b00d471fe502be9ade
MD5 84ffde1f5135de7ef35b8cb22fe00fbb
BLAKE2b-256 e4f187c1071dbca64cb49d74e94e59a079ee5e3913d933c6473c1e2aaf0b5dbc

See more details on using hashes here.

Provenance

The following attestation bundles were made for deputy_cli-0.1.0-py3-none-any.whl:

Publisher: publish.yml on gurveervirk/deputy

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