Local Java code intelligence indexer backed by a graph database

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for vinayak3022 from gravatar.com vinayak3022

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT License (MIT License)
  • Author: CodeSpine contributors
  • Tags java , code-indexing , graph , kuzu , mcp
  • Requires: Python >=3.10
  • Provides-Extra: ml , community , full
Classifiers
Report project as malware

Project description

CodeSpine

CodeSpine is an intelligence layer for Java teams and AI coding agents. It maps your codebase into a live graph so you can find anything fast, predict change impact, and ship safer refactors.

Installation

pip install codespine

Quick Start

codespine analyse .
codespine search "payment retry bug" --json
codespine context "processPayment" --json
codespine impact "com.example.Service#processPayment(java.lang.String)" --json

Example analyze output:

$ codespine analyse .
Walking files...               142 files found
Parsing code...                142/142
Tracing calls...               847 calls resolved
Analyzing types...             234 type relationships
Detecting communities...       8 clusters found
Detecting execution flows...   34 processes found
Finding dead code...           12 unreachable symbols
Analyzing git history...       18 coupled file pairs
Generating embeddings...       623 vectors stored

Done in 4.2s - 623 symbols, 1847 edges, 8 clusters, 34 flows

What You Get

  • Hybrid search: BM25 + semantic vectors + fuzzy + RRF
  • Impact analysis: depth groups with confidence scoring
  • Java-aware dead code detection with exemption passes
  • Execution flow tracing from entry points
  • Community detection (Leiden + fallback)
  • Git change coupling analysis
  • Watch mode incremental reindexing
  • Symbol-level branch diff

Key Commands

  • codespine analyse <path> [--full|--incremental]
  • codespine search <query> [--k 20] [--json]
  • codespine context <query> [--max-depth 3] [--json]
  • codespine impact <symbol> [--max-depth 4] [--json]
  • codespine deadcode [--limit 200] [--json]
  • codespine flow [--entry <symbol>] [--max-depth 6] [--json]
  • codespine community [--symbol <symbol>] [--json]
  • codespine coupling [--months 6] [--min-strength 0.3] [--min-cochanges 3] [--json]
  • codespine diff <base>..<head> [--json]
  • codespine watch [--path .] [--global-interval 30]

MCP Setup (mcp.json)

{
  "mcpServers": {
    "codespine": {
      "command": "codespine",
      "args": ["mcp"]
    }
  }
}

Runtime Paths

  • ~/.codespine_db
  • ~/.codespine.pid
  • ~/.codespine.log
  • ~/.codespine_embedding_cache.sqlite3

Project Docs

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for vinayak3022 from gravatar.com vinayak3022

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT License (MIT License)
  • Author: CodeSpine contributors
  • Tags java , code-indexing , graph , kuzu , mcp
  • Requires: Python >=3.10
  • Provides-Extra: ml , community , full
Classifiers

Release history Release notifications | RSS feed

1.0.13

1.0.12

1.0.11

1.0.10

1.0.9

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

0.9.9

0.9.8

0.9.7

0.9.6

0.9.5

0.9.4

0.9.3

0.9.2

0.9.1

0.9.0

0.8.0

0.7.3

0.7.2

0.7.1

0.7.0

0.6.3

0.6.2

0.6.1

0.6.0

0.5.10

0.5.9

0.5.8

0.5.7

0.5.6

0.5.5

0.5.4

0.5.3

0.5.2

0.5.1

0.5.0

0.4.3

0.4.2

0.4.1

0.4.0

0.3.0

This version

0.1.9

0.1.8

0.1.7

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

Download files

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

Source Distribution

codespine-0.1.9.tar.gz (36.0 kB view details)

Uploaded Source

Built Distribution

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

codespine-0.1.9-py3-none-any.whl (41.4 kB view details)

Uploaded Python 3

File details

Details for the file codespine-0.1.9.tar.gz.

File metadata

  • Download URL: codespine-0.1.9.tar.gz
  • Upload date:
  • Size: 36.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for codespine-0.1.9.tar.gz
Algorithm Hash digest
SHA256 4656d5598e55fdc4f781540d67d610fd5f3f96a08538a36e090d8ef91ac44352
MD5 657716b6d16de56528baafcbc97b8921
BLAKE2b-256 3a6c39deae6105a36c5b44107559fcca01a90e510bb74dbce250e4da7d36db15

See more details on using hashes here.

Provenance

The following attestation bundles were made for codespine-0.1.9.tar.gz:

Publisher: publish-pypi.yml on vinayak3022/codeSpine

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

File details

Details for the file codespine-0.1.9-py3-none-any.whl.

File metadata

  • Download URL: codespine-0.1.9-py3-none-any.whl
  • Upload date:
  • Size: 41.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for codespine-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 a00f6d458a9d075d74ec3d25db14ed182236576e6d2d6a5cca42ba0bebc3cee0
MD5 e95f0dd9ac69d7317218a4262b12a2c9
BLAKE2b-256 067f8303bf9c4a2365dca2144a3b41271b837e9159535ee2af5dedf288057d31

See more details on using hashes here.

Provenance

The following attestation bundles were made for codespine-0.1.9-py3-none-any.whl:

Publisher: publish-pypi.yml on vinayak3022/codeSpine

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