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

0.1.9

0.1.8

0.1.7

0.1.5

This version

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.4.tar.gz (33.1 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.4-py3-none-any.whl (39.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: codespine-0.1.4.tar.gz
  • Upload date:
  • Size: 33.1 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.4.tar.gz
Algorithm Hash digest
SHA256 92542b7173ce9047f482369b4aedae7c85d7e895ea6bfadc9305c22a6aea1a66
MD5 ec79b677c7de0ade78015dfb08660ac3
BLAKE2b-256 9f5c5fa7060268a8d4378d9f4ea2e98219b498347cdc758e811dcf71c351ab95

See more details on using hashes here.

Provenance

The following attestation bundles were made for codespine-0.1.4.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.4-py3-none-any.whl.

File metadata

  • Download URL: codespine-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 39.0 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 cd9fb051a362b252119ac2da56de540bcc8c4791e79e2834d9e4d43c8b699943
MD5 7ca22d9980edfac593312e5ba3b7932f
BLAKE2b-256 0089fbb6f58692de6992b209ae1564b5dd3a21d58d91cf54215aefc4eed7c4bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for codespine-0.1.4-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