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

0.1.4

This version

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.3.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.3-py3-none-any.whl (39.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: codespine-0.1.3.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.3.tar.gz
Algorithm Hash digest
SHA256 f757cf8b91118f1b2b7430d1ebe28a40760df7df3337aa60ea4b303ca59852e7
MD5 14b36135d564214522250afeb536a9c6
BLAKE2b-256 4249f6b28b88b990d413efb3ec578c1c0161b50885f8ff08dda53641650657ab

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: codespine-0.1.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 f5bb44f2d7755bfb06e71a917cc101600e9865ae9f04f841cd3b8a57c4f60998
MD5 28dc3dee9dede3ebf2e6b328f85c4308
BLAKE2b-256 2b4900976889307705491df8a2d132ca66726718e564af93f5841e8603aac565

See more details on using hashes here.

Provenance

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