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

This version

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.8.tar.gz (35.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.8-py3-none-any.whl (40.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: codespine-0.1.8.tar.gz
  • Upload date:
  • Size: 35.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.8.tar.gz
Algorithm Hash digest
SHA256 5ebd2bf5affbc9cecf86d98c9444795df7a970be6a44f7c78d16a03d18f0fae0
MD5 69b2541b7e81a558db0041ed8ff43f86
BLAKE2b-256 f31ff63b8cc2754c0c99267785361e8732ec71d5bcf175330d32c6753e49c0eb

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: codespine-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 40.5 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.8-py3-none-any.whl
Algorithm Hash digest
SHA256 55c3ba0d954363e95d2f19b4165d6c41c824c7fc22642dbbb2d87369196134ca
MD5 1e3812dfbece4bb129822f17f90faf48
BLAKE2b-256 f096918ca131719017a65c38301188acef6dffabf422765843685a32d63fbba4

See more details on using hashes here.

Provenance

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