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

This version

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.5.tar.gz (33.8 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.5-py3-none-any.whl (39.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: codespine-0.1.5.tar.gz
  • Upload date:
  • Size: 33.8 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.5.tar.gz
Algorithm Hash digest
SHA256 cdd2a7a4545e6a901c0bd83ef7452c0ac16180061d72eea50fa05c8a0fa60b17
MD5 34c2c165df251baef221040fc1f8ae7a
BLAKE2b-256 7bd781bf2706727f22ec04699987cc5188299d7932889cfdb2e869b0b486cf09

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: codespine-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 39.7 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 f53aeb84335192807c19fc4f69f012b9ba07f166ef9d7363fceec9b1cfd741cf
MD5 8958dd61007853ccd87620684822e575
BLAKE2b-256 aca7eec99161762843f8b015e7ff8408d44489eba797ad5c48335e18a2d72ff5

See more details on using hashes here.

Provenance

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